Description |
Example |
Return message |
GroupTE_Track
Add or promote a Track
Syntax
TE_Track <ScenarioPath> {Add | Promote | Demote | Point | Label | Filter} <Parameters>
Related commands
Description
TETK must be installed in order to use this command.
The TE_Track command with the Add option enables you to create a TETK Track Workflow and associated STK MTO object.
The TE_Track command with the Promote option enables you to promote a TETK Track Workflow and associated STK MTO object to an STK Aircraft.
The TE_Track Points and Labels commands control the visual representation of the sensor measured MTO track data in the STK 3d Graphics view.
The following table describes the parameters for the options.
| Option | <Parameters> |
|---|
| Add | | Name "<TrackName>" | The display name of the track | | AnalysisObject "<AnalysisObjectName>" | The name of the Ownship that contains the data to the track. | | Mapping "<MappingName>" | The mapping name to use to create the track. | | FrameObject "<FrameObjectName>" | Optional. Set the source of the reference frame specified in the selected track mapping. | | PickMapping "<PickMappingName>" | Optional. The pick mapping name to use to display results when you click on the track. | | TrackIDs "<CommaSepTrackIDs>" | Optional. A comma separated list of the integer Track IDs that should be displayed. If not entered, all Track IDs will be displayed. | | IdsExclude | Optional. By default,the list of TrackIDs are included. Using this keyword excludes the list of TrackIDs. | | TimePath "<PathToTimeInterval>" | Optional. The STK path to a Time Interval component that the track should be limited to. | | Type "<ObjectType>" | Specifies the object type that is created when a track is promoted. Valid values include aircraft, groundVehicle, launchVehicle, missile, satellite, and ship. | | Reader "{ReaderName | fileName}" | Optional. Enter either the name of the the reader for the file from which the data should be read or enter the file name. For ReaderName, the name can be found on the Data Import GUI. This parameter is only needed when more than one file has the same track mapping. For fileName, enter the name of the file, not the full file path. Both ReaderName and fileName accept comma separated lists of names. |
|
| Duplicate | | Name "<TrackName>" | The name of the track that is being duplicated. | | NewName "<TrackName>" | Specifies a new name for the duplicated track. |
|
| Promote | | Name "<TrackName>" | The display name of the track that is being promoted. | | Type "<ObjectType>" | Specifies the object type that is created when a track is promoted. Valid values include aircraft, groundVehicle, launchVehicle, missile, satellite, and ship. |
|
| Demote | Name "<TrackName>" The display name of the track that is being demoted. |
| Points | | Name "<TrackName>" | The display name of the track | | Show {On | Off} | Indicate whether to show the points. | | DynamicSettings "{Static | Dynamic | Current}" | Type of display. The default value is Static. If DynamicSettings is set to Dynamic, then it also accepts LeadTime and TrailTime as positive integers in seconds. Default is 0,0. | | ColorDisplayType "{Static | Dynamic | TrackID}" | Type of color display. | | ColorContourType "{Smooth | Threshold | Unique}" | Type of contour. | | ConnectPoints "{On | Off}" | Indicate whether the Connect Track Points option in TETK is enabled or disabled. | | SetParameter "<ParamName>" | Enter the name of the parameter for the point. | | StaticColor "{Color}" | Set the track color. Valid if ColorDisplayType is Static. | | MinColor "{Color}" | The minimum contour color. Valid if ColorContourType is Smooth. | | MaxColor "{Color}" | The maximum contour color. Valid if ColorContourType is Smooth. | | InsideColor "{Color}" | The color inside the threshold. Valid if ColorContourType is Threshold. | | OutsideColor "{Color}" | The color outside the threshold. Valid if ColorContourType is Threshold. | | MinValue "<Value>" | With the MaxValue option specify a point value range for generating a color ramp with MinColor and MaxColor values. | | MaxValue "<Value>" | With the MinValue option specify a point value range for generating a color ramp with MinColor and MaxColor values. | | UniqueValues "<value>,<color>,{icon},..." | Specify the color and icon to use for specific Track values. <value>,<color>,{icon} can be entered multiple times within the double quotes. Valid values for {icon} include Circle, Point, Plus, Star, Square, Triangle. Valid if ColorContourType is Unique. | | Units "{UnitAbbrev}" | Specify the units that MinValue, MaxValue and UniqueValues are entered in. | | OwnshipLineShow "{On | Off}" | Displays the ownship line. The default value is Off. | | OwnshipLineStep "<PositiveInteger>" | Defines the ownship line step. The default value is 1. | | Translucency "<Value>" | Enter a translucency value for the track points. Acceptable values range from 0 - 100. The default value is 0, which is fully opaque. | | BoundsConstraint "<MinLatitude>,<MaxLatitude>,<MinLongitude>,<MaxLongitude>" | Set a bounds constraint on the track points by specifying the minimun and maximum latitude and longitude of the boundary. Values must be in degrees and comma separated. | | ShowAppliedConstraint {On | Off} | Indicate whether to show the applied bounds constraint. |
|
| Labels | | Name "<TrackName>" | The display name of the track | | Show {On | Off} | Indicate whether to show the labels. | | SetColor "{Color}" | Set the label color. | | SetParameter "<ParamName>" | Enter the name of the parameter that the label is displaying. | | SignificantDigits "<Value>" | Enter number of decimals places to display. | | MaxDisplayAlt "<Value>" | The maximum altitude difference between the camera and the point at which the point's label should display. | | MaxDisplayUnit "{UnitAbbrev}" | The unit that the MaxDisplayAlt value is entered in. |
|
| Filter A filter can consist of multiple Segments | | Segment Logic {And | Or} | After the first segment, this keyword is required. | | Segment DataElement "<Source Name> | <Short Name>" | Enter the data element's source name and short name. If the Short Name is unique, you can skip the source name. | | Limits "{Bounded | Explicit | Greater | Less | ExplicitList}" | Enter the limit you want to define.
- Bounded - "<Value> <Unit>, <Value> <Unit>"
- Explicit - "<Value> <Unit>"
- Greater - "<Value> <Unit>"
- Less - "<Value> <Unit>"
- ExplicitList - "<Value> <Unit>, <Value> <Unit> ..."
ExplicitList supports a list of value unit pairs. Use of Explicit or ExplicitList is hard to get a match on double values. |
|
| AssignTruth | | Name "<TrackName>" | The display name of the track that is being assigned a truth object. | | TruthPath "<STK Object Path>" | The scenario path to the STK object that will be assigned as the track's truth object. |
|
| CurrentMarker | | Name "<TrackName>" | The display name of the track | | Show {On | Off} | Indicate whether to show the Current Marker. | | Type "<MarkerType>" | Set the current marker type. Valid values are None, Circle, Square, Triangle Up, Triangle Down, Diamond, Double Square, 4 Pointed Star, 5 Pointed Star, Pentagon, Plus, X and Metric.
The setting type of "Metric" is used for Markers By Metric and will require DataElement and MetricMarkers options to also be set. | | SetColor "{Color}" | Set the current marker color. | | Size "<Value>" | Enter the size in pixels of the marker. Value must be greater than 0. | | Width "<Value>" | Enter stroke width of the marker. Values can range between 1 and 10. | | Label "<Value>" | Set the label for the marker. | | ShowLabel {On | Off} | Indicate whether to show the marker label. | | LabelColor "{Color}" | Set the marker label color. | | LabelX "<Value>" | Enter the X offset in pixels of the marker label. | | LabelY "<Value>" | Enter the Y offset in pixels of the marker label. | | DataElement "<Value>" | The Data Element to use for Markers by Metric. | | MetricMarkers "<Metric Value1>,<Marker Type1>,<Metric Value2>,<Marker Type2>,..." | A comma separated list of value and marker type pairs to be compared against the set Data Element to create Markers by Metric. Valid marker type values are None, Circle, Square, Triangle Up, Triangle Down, Diamond, Double Square, 4 Pointed Star, 5 Pointed Star, Pentagon, Plus, and X. | | MetricColors "<Metric Color1>,<Metric Color2>,..." | A comma separated list of colors for each Metric Marker. Empty color strings will use the default marker color of white. | | ShowMetricLabels "<{On | Off}>,<{On | Off}>,..." | A comma separated list of values indicating if Metric Marker labels should be displayed. Empty strings will use the default Show value of Off. | | MetricLabels "<Label1>,<Label2>,..." | A comma separated list of label values for the Markers. Empty strings are valid label values. | | MetricLabelColors "<Label Color1>,<Label Color2>,..." | A comma separated list of colors for each Marker Label. Empty color strings will use the default label color of white. |
|
| MarkerConfig | | Name "<TrackName>" | The display name of the track | | Save "<Config Name>" | Save the track's Current State Marker Config with the given name. | | Set "<Config Name>" | Set the track's Current State Marker Config to the saved config with the given name. | | Delete "<Config Name>" | Delete the saved Current State Marker Config with the given name. |
|
Examples
Create a TETK Track Workflow and associated STK MTO object:
TE_Track * Add Name "MyTrack" AnalysisObject "My_Ctdf_Aircraft" Mapping "MeasuredDroneDataMapping" PickMapping "DronePickMapping" TrackIDs "1,2" TimePath "Aircraft/My_Ctdf_Aircraft AvailabilityTimeSpan"
Duplicate an existing TETK Track Workflow and provide a new name for it:
TE_Track * Duplicate Name "Track" NewName "TrackDup"
Promote a TETK Track Workflow and associated STK MTO object to an STK Aircraft:
TE_Track * Promote Name "MyTrack"
TE_Track Points example:
TE_Track * Points Name "MyTrack" Show "On" ColorDisplayType "dynamic" ColorContourType "smooth" SetParameter "Magnitude" MinColor "red" MaxColor "blue" MinValue "0" MaxValue "100"
Display a dynamic track point and show the ownship line with a defined ownship line step value:
TE_Track * Points Name "Track4" AnalysisObject "AF385" DynamicSettings "Dynamic" LeadTime "20" TrailTime "20" Translucency "20" OwnshipLineShow "On" OwnshipLineStep "10"
TE_Track Labels example:
TE_Track * Labels Name "MyTrack" Show "On" SetColor "red" SetParameter "Magnitude" SignificantDigits "2" MaxDisplayAlt "10" MaxDisplayUnit "km"
Specify unique values for a TE_Track Points command:
TE_Track * Points Name "MyTrack" ColorDisplayType "dynamic" ColorContourType "unique" SetParameter "Magnitude" Units "km" UniqueValues "1.1,Green,Plus,2.5,Red,Square,3,Blue,Circle"
Change an associated STK MTO object color using RGB values:
TE_Track * Points Name "MyTrack" Show "On" DynamicSettings "Static" StaticColor "%000153051"
Excluding the list of TrackIDs:
TE_Track * AddName "Track4" AnalysisObject "AF385" Mapping "AF385_TrackID" TrackIDs "2" IDsExclude
Filtering by Longitude:
TE_Track * Filter Name "Track2" AnalysisObject "AF385" Segment DataElement "Longitude" Limits "Bounded, -2.05 rad, -2.03 rad"
Filtering by Latitude and Track ID:
TE_Track * Filter Name "Track5" AnalysisObject "Af385" Segment DataElement "Latitude" Limits "Greater, 100 deg" Segment Logic "And" DataElement "Track_ID" Limits "Explicit, 1 unitless"
Assigning a Truth Object:
TE_Track * AssignTruth Name "MyTrack" TruthPath "*/Aircraft/MyTruth"
Set the Current Marker:
TE_Track * CurrentMarker Name "MyTrack" Show "On" SetColor "blue" TYPE "Square" Size "42" Width "4" Label "MyLabel" LabelColor "pink" LabelX "22" LabelY "-10" ShowLabel "On"
Set Markers by Metric:
TE_Track * CurrentMarker Name "MyTrack" Show "On" TYPE "Metric" DataElement "Mode" MetricMarkers "1,Square,2,Circle,3,X" Size "42" Width "4"
Set Markers by Metric with Colors and Labels:
TE_Track * CurrentMarker Name "MyTrack" Show "On" Type "Metric" DataElement "Mode" MetricMarkers "1,Square,2,Circle,3,X" MetricColors "Red,Green,Blue" ShowMetricLabels "On,Off,On" MetricLabels "ID1,,ID3" MetricLabelColors "Red,,Green" Size "42" Width "4"
Save a Track's Current Marker Settings as a Metric Configuration:
TE_Track * MetricConfig Name "MyTrack" Save "MyConfigName"
Set a Track's Metric Configuration:
TE_Track * MetricConfig Name "MyOtherTrack" Set "MyConfigName"
Delete a Metric Configuration:
TE_Track * MetricConfig Name "MyTrack" Delete "MyConfigName"
Return message
Group membership
This command belongs to the following group(s):
T & E Toolkit
You can use TETK Connect commands in TETK scenarios for pre-flight planning, post-flight analysis, and to support analysis workflows.
You should not use TETK Connect commands when real-time propagators are creating STK vehicles and using STK features instantaneously. The use of Connect commands in a real-time application requires more computational power than STK can support.
TETK functionality that is commonly referred to as "real-time" is actually an offline analysis mode. In this mode, an STK/TETK scenario is prepared with data that is streamed to a particular time in a mission. The post-flight analysis can be prepared again on demand throughout the mission for the data for each time of request. You can use TETK Connect commands in these scenarios.
Version
12.9