Description | Example | Return message | Group

TE_DataDisplay

Add a display which shows data changing over time.

Syntax

TE_DataDisplay <ObjectPath> {Add | Modify} Name "<Name>" AnalysisObject "<Name>" {Interval | Numeric} <Parameters> {Show "<On | Off>"}

Related commands

Description

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

The TE_DataDisplay command adds a data display to an STK 3D window.

Name "<Name>" specifies the name of the contour. This parameter is required.

AnalysisObject "<Name>" is the name of the analysis object. This parameter is required.

The following table describes parameters used for the Add option.

<Parameters>Description
DataElement "<Description>"Enter comma separated data describing the data element "<DataElement>,<label>,<units>,<ShowUnits>"

<ShowUnits> can be On or Off.

The format for specifying <DataElement> is: "[<SourceName> |] <ShortName>". If the <ShortName> is enough to identify the element then just enter that. Otherwise, include the <SourceName> followed by the | (bar), before the <ShortName>. Refer to examples of each below.

Interval <Name>,<Label>,..."Enter comma separated pairs of time interval name and label.

The following table describes parameters used for the Modify option.

<Index> indicates which DataElement to modify. The first value is 1.

<Parameters>Description
DataElement "<Description>"Enter comma separated data describing the data element "<Index>,<DataElement>,<label>,<units>,<ShowUnits>"

<Index> indicates which DataElement to modify. The first value is 1.

<ShowUnits> can be On or Off.

The format for specifying <DataElement> is: "[<SourceName> |] <ShortName>". If the <ShortName> is enough to identify the element then just enter that. Otherwise, include the <SourceName> followed by the | (bar), before the <ShortName>. Refer to examples of each below.

Interval <Index>,<Name>,<Label>,..."Enter comma separated pairs of time interval name and label.

The following table describes the rest of the parameters used for either option.

<Parameters>Description
Color "<Color>"Enter a color. Color may be entered using name, value or %rgb.
FontSize "<value>"Enter the font size in points.
Width "<value> | auto"Enter the width in pixels or auto to automatically size the display based on its contents.
Digits "<value>"Enter the number of digits to display.
Translucency "<value>"Enter a translucency value for the background of the data display. Acceptable values range from 1 - 100. The default value is 50.
Location "<cornerNum>,<xOffset>,<yOffset>, {Pixel | Percent}"Enter the location. <cornerNum> can be 1 - 4.
VoWindow "<WindowNum>"Enter the index of STK 3D window (starting at 0).
Gauge "<Bar | Dial | Dial360 | Artificial Horizon>, {min minUnit, max maxUnit}"Analysis object must have Pitch and Roll numeric elements to use Artificial Horizon. Note: When displaying an artificial horizon via Connect, only Pitch and Roll must be supplied. Additional data elements are not supported. Note: Bar and dial-type data displays only support a single data element.
TimeConstraint "<Value>"Specify the name of a time constraint. This parameter supports fully qualified names as well as just the middle word of the name.
Gradient "<Index>, <Data Element>, {<Value1> <Unit1>, <Color1>, <Value2> <Unit2>, <Color2>...}"Specify a contour to colorize the data display.
Show "<On | Off>"

Show/Hide the graphic element.

SVGFile "<Filepath>"

Enter the path to the custom SVG file.

Examples

TE_DataDisplay * Add Name "Data1" AnalysisObject "AF3_0385" Numeric DataElement "Latitude, Lat, deg, ON"
TE_DataDisplay * Add Name "Data2" AnalysisObject "AF3_0385" Numeric DataElement "Longitude, Lon, deg, ON" Color "orange" FontSize "10" Width "250" Digits "1" Location "1,25,25" VoWindow "0"
TE_DataDisplay * Add Name "Data3" AnalysisObject "AF3_0385" Numeric DataElement "Latitude, Lat, rad, ON" Gauge "Dial"
TE_DataDisplay * Add Name "Data4" AnalysisObject "AF3_0385" Numeric DataElement "Longitude, Lon, rad, ON" Gauge "Dial360"
TE_DataDisplay * Add Name "Data5" AnalysisObject "AF3_0385" Numeric DataElement "Pitch, Pitch, deg, ON" DataElement "Roll, Roll, deg, ON" Gauge "Artificial Horizon"
TE_DataDisplay * Add Name "Data6" AnalysisObject "AF3_0385" Numeric DataElement "Latitude, Lat, deg, OFF" DataElement "Longitude, Lon, deg, ON" Color "%255255000" TimeConstraint "run1"
TE_DataDisplay * Add Name "Data7" AnalysisObject "AF3_0385" Interval "AvailabilityTimeSpan, Available" color "-23296" FontSize "10" Width "250" Location "1,25,25" VoWindow "0"
TE_DataDisplay * Add Name "Data8" AnalysisObject "AF3_0385" Interval "AvailabilityTimeSpan, Available" Interval "run1, run2"
TE_DataDisplay * Add Name "DataElems" AnalysisObject "AF3_0385" Numeric DataElement "AF3_0385_MeasuredTracks_ID.csv | Latitude, Lat, deg, ON"

Specify a static color for a data element

TE_DataDisplay * Add Name "Data9" AnalysisObject "AF3_0385" Numeric Data Element "Ownship.csv | Cal Air Speed, Cal Air Speed, knots, on, red" Color "Green"

Specify a contour for a data element

TE_DataDisplay * Add Name "Data10" AnalysisObject "XF1_0123" Numeric DataElement "Ownship.csv | Cal Air Speed, Cal Air Speed, knots, on" Color "White" Gradient "1, Cal Air Speed, 0.0 knots, red, 200 knots, green, 300 knots, red"

Add a file path to an SVG file.

TE_DataDisplay * Add Name "SVGDisplay" AnalysisObject "XF1_0123" Numeric DataElement "Ownship.csv | Latitude, deg, off" SVGFile "C:\Program Files\AGI\STK 12\Help\TeTraining\Training files\circle.svg" Show "On"

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.2