TE_AnalysisObject
Import an Ownship data file.
Syntax
TE_AnalysisObject <ScenarioPath> Add {<Parameters>}
TE_AnalysisObject <ScenarioPath> Delete Ownship "<OwnshipName>" SourcePath "<FilePath>"
Related Commands
Description
The T&E Toolkit Plugin must be installed in order to use this command.
The TE_AnalysisObject command will import an Ownship track file.
A vehicle of the specified type, default of aircraft, will be created in STK. An ownship will be created in T&E Flight Analysis Tool (FAT). If you already have a vehicle created and configured in STK, then you can use the keyword AttachTo to have the TE_AnalysisObject command apply the data file to that vehicle. If you would like to use attributes of the STK object within T&E (values not in the data file) then you can use the keyword FromSTK and list the attributes to make known to T&E.
Parameters can be entered in any order.
Use the following format to specify a data file.
TE_AnalysisObject <ScenarioPath> Add File "<FilePath>" Name "<DisplayName>" [Model "<ModelPath>"]
The following table describes the parameters for this format.
| Parameter | Description |
|---|---|
| File "<FilePath>" | Enter a file path to an object track file. Supported file formats are csv, ctdf, amcat, qview, and h5td. |
| Name "<DisplayName>" | The display name of the vehicle. |
| Model "<ModelPath>" | Enter the file path to a model file to represent the vehicle. This parameter is optional. |
| TSPIMapping "<MappingName>" | Enter the name of the TSPI data mapping for the data. This parameter, while recommended, is optional. |
| TimeColumn "<Name>" | Enter the name of the time column. A time data mapping for this file type must contain a time column of this name. This parameter, while recommended, is optional. |
| UnitsFile "<FilePath>" | Enter the full path to the units definition file. This parameter is optional. |
| TimeEpoch "<DateTimeString>" | Enter the relative start time for the data.
This must be defined if you use the TimeUnits parameter. A daysecond or HMS TimeUnit requires a timeEpoch of midnight. |
| TimeUnits "<Value>" | Enter the time units. Valid options are Day, hour, minute, second, millisecond, microsecond, nanosecond, daysecond, and HMS. Second is the default.
This parameter is optional; if used, the TimeEpoch parameter is required. |
Use the following format to apply the data file to an existing STK object.
TE_AnalysisObject <ScenarioPath> Add AttachTo "STKObject" File "<FilePath>"
The following table describes the parameters for this format.
| Parameter | Description |
|---|---|
| AttachTo "<STKObject>" | Enter the name of an STK object. |
| File "<FilePath>" | Enter a data file path. Supported file formats are csv, ctdf, amcat, qview, and h5td. |
Use the following format to use attributes of an STK object within T&E (values not in the data file) listing the attributes to make known to T&E.
TE_AnalysisObject <ScenarioPath> Add FromSTK [TimeStep "<seconds>"] Scalars "<Parameter>" Name "<DisplayName>" [ObjectType "<ObjectType>"]
The following table describes the parameters for this format.
| Parameter | Description |
|---|---|
| FromSTK [TimeStep "<Seconds>"] Scalars "<ScalarParam>" | For TimeStep entered the time in seconds. This parameter is optional. "<ScalarParam>" is "<objecttype>:<scalarname>[\\<subscalarname>]" where \\<subscalarname> is optional and multiple <scalarname>[\\<subscalarname>] can be entered, separated by commas. For example: "aircraft:Heading,LLA State""missile:LLR State\\TrueOfDate" "ship:Heading,Vectors\\Position" "launchvehicle:Classical Elements\\ICRF" |
| Name "<DisplayName>" | The display name of the vehicle. |
| ObjectType "<ObjectType>" | Enter the type of object. Valid values are aircraft, missile, ship, satellite, and ground vehicle. This parameter is optional. |
The following table describes the parameters for the Delete command.
| Parameter | Description |
|---|---|
| Ownship "<OwnshipName>" | Enter the name of the loaded Ownship. |
| SourcePath "<FilePath>" | Enter the source path of the ownship. |
Example
To import an Ownship track file into STK and T&E:
TE_AnalysisObject * Add File "c:\data\214f592.ctdf" Name "My_Ctdf_Aircraft" Model "c:\Program Files\AGI\STK 11\STKData\VO\Models\Air\f-22a_raptor.mdl"
To import a detailed Ownship track file into STK and T&E:
TE_AnalysisObject * Add File “C:\data\foo.csv” Name “trek” TSPIMapping “trektspi” TimeColumn “Time” UnitsFile “C:\data\unitsdef.def” TimeEpoch “25 May 2019 14:15:16.17” TimeUnits “second”
FromSTK example:
TE_AnalysisObject * Add Name "miss1" ObjectType "Missile" FromSTK timeStep "1" scalars "missile:LLR State\\TrueOfDate"
AttachTo example:
TE_AnalysisObject * Add AttachTo "ground1" File "\\\agi\common\Dev\TnE_Toolkit\Data\Flight_385_Test_Additional_Objects\GroundVehicle1 GroundVehicle.csv"
To delete an Ownship track file:
TE_AnalysisObject * Delete SourcePath "\\\agi\common\Dev\TnE_Toolkit\Data\Ownship\F35.AF3.0385.00017.001.0001.FTI_ICP_MSOSS_Statevector.lst" Ownship "AF3_0385"
ReturnMessage
Group Membership
This command belongs to the following group(s):
Version
11.7