Description | Example | Return Message | Group

TE_Track

Add or promote a Track

Syntax

TE_Track <ScenarioPath> {Add | Promote | Demote | Point | Label | Filter} <Parameters>

Related Commands

Description

The T&E Toolkit Plugin must be installed in order to use this command.

The TE_Track command with the Add option allows you to create a T&E Track Workflow and associated STK MTO object.

The TE_Track command with the Promote option allows you to promote a T&E 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.
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.
TimePath "<PathToTimeInterval>"Optional. The STK path to a Time Interval component that the track should be limited to.
Reader "<ReaderName>"Optional. The name of the reader for the file from which the data should be read. The name can be found on the Data Import GUI. This parameter is only needed when more than one file has the same TSPI mapping
PromoteName "<TrackName>"

Enter the display name of the track that should be promoted.

DemoteName "<TrackName>"

Enter the display name of the track that should be demoted.

Points
Name "<TrackName>"The display name of the track
Show {On | Off}Indicate whether to show the points.
ColorDisplayType "{Static | Dynamic}"Type of display.
ColorContourType "{Smooth | Threshold | Unique}"Type of contour.
SetParameter "<ParamName>"Enter the name of the parameter for the point.
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.
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.

Example

To create a T&E 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"

To promote a T&E 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"

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"

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"

ReturnMessage

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

11.7.1