TE_Graph
Create a contour to color the data.
Syntax
TE_Graph <ObjectPath> {Add | Save | Delete | Modify | Refresh} Name "<Name>" AnalysisObject "<Name>" {GraphXY | Multigraph | ColorLine} <Parameters>
Related Commands
Description
The T&E Toolkit Plugin must be installed in order to use this command.
Generate a graph in T&E Toolkit.
GraphXY graphs may have multiple lines but the dimensions must be the same.
Multigraph graphs may have multiple lines with different dimensions.
Name "<Name>" specifies the name of the graph. This parameter is required.
AnalysisObject "<Name>" is the name of the analysis object. This parameter is required.
If the option is Add, then either Segment Color or Segment Gradient must be entered.
The following table describes the Segment parameters which are used for the Add option.
| <Parameters> | Description |
|---|---|
| Segment Color "<Color>" | Enter a color. |
| Segment Gradient "<DataElement>,<Value1>,<Color1>,<Value2>,<Color2>,..." | Enter the data element, followed by a comma separated list of value, color. See below for format of <DataElement>. |
| BelowColor "<value>" | Enter a color value (named color, RGB, or hue). If you do not specify a color, the BelowColor will be turned off. This keyword only is used in conjunction with the Segment Gradient keyword. |
| Above "<ON | OFF>" | Define if the segment displays a color for values above the highest specified value. This keyword only is used in conjunction with the Segment Gradient keyword. |
| Point Size "{Small | Large | Medium | Micro}" | Enter the size. |
| Point "{1.0 | 1.5 | 2.0 | 2.5 | 3.0}" | Enter the point. |
When using the Modify option, you must specify which Segment you are modifying. The following table describes the Segment parameters which are used for the Modify option.
| <Parameters> | Description |
|---|---|
| Segment "<Value>" Color "<Color>" | Enter the segment number, then the color to modify. |
| Segment "<Value>" Gradient "<DataElement>,<Value1>,<Color1>,<Value2>,<Color2>,..." | Enter the segment number, then the data element to modify, followed by a comma separated list of values and colors. See below for format of <DataElement>. |
| Segment "<Value>" BelowColor "<value>" | Enter a color value (named color, RGB, or hue). To turn off the BelowColor, enter Off. This keyword only is used in conjunction with the Segment Gradient keyword. |
| Segment "<Value>" Above "<ON | OFF>" | Define if the segment displays a color for values above the highest specified value. This keyword only is used in conjunction with the Segment Gradient keyword. |
| Segment "<Value>" Point Size "{Small | Large | Medium | Micro}" | Enter the segment number, then the size of the segment point. |
| Segment "<Value>" Point "{1.0 | 1.5 | 2.0 | 2.5 | 3.0}" | Enter the segment number, then the the point. |
The following table describes the parameters which are used for the Add or Modify option.
| <Parameters> | Description |
|---|---|
| DataElement "<DataElement1>,<DataElement2>,..." | A comma separated list of names of the data elements to be plotted.
See below for format of <DataElement>. If only one data element is defined, you must include the XIsTime parameter. |
| XIsTime | Enter to specify that the x-axis will show time. |
| Labels "<Name1>,<Name2>,..." | A comma separated list of Y-axis labels. |
| Units "<Unit1>,<Unit2>,..." | A comma separated list of unit names to use for Y-axis. |
| TimeConstraint "<Value>" . | Specify the name of a time constraint. |
| HorizontalLine "<value>,<label text>,<color>" | Enter horizontal line information. If using the Modify option, you also have an {On | Off} toggle option. |
| Step "<value>" | Enter the name of STK object to use its time step to "thin" the data. If using the Modify option, you have the option to set this parameter to None. |
| Overlay "<value>" | List of file, color, line thickness {thin, medium, thick}, line type {line solid, line dash, line dot, square, triangle, dot}, transparency value, fill color, fill transparency (Only the file value is required; the rest are optional).
Each of these values have a default value. These values can be overwritten by the header values in the file. Lastly, values defined on this command line override both of these values. If using the Modify option, the file name entered determines the overlay you want to modify. If this file name is not recognized, then a new overlay is created. Header values in the file are ignored when using the Modify command. Also, you have the option to set this parameter to None. |
| AnimationLine "<Color>" | Enter a color. If using the Modify option, you also have an {On | Off} toggle option. |
| ConnectDots "{On | Off}" | |
| ExtentY "<Value>" | Define a specific Y axis limit. This value is in the current units. |
| ExtentX "<Value>" | Define a specific X axis limit. This value is in the current units. |
| SlideTrail "<Value>" | Define the trail minutes in the slide window of the graph. |
| SlideLead "<Value>" | Define the lead minutes in the slide window of the graph. If the trail and lead values are 0, slide mode is disabled. |
| FastAnimation "<On | Off>" | Toggle if using fast animations. |
| Position "<Value>,<Value>,<Value>,<Value>" | Enter two (x,y) positive integers to define the position of the graph, or enter four (x,y,w,h) positive integers to define the position and size of the graph. |
Color may be entered using name, value or %rgb.
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.
The Overlay will the line properties that are defined in the head of the file if not defined in the command. Values entered using the Overlay command will override values in the head of the file.
The following table describes the parameters for the Save and Delete options.
| <Parameters> | Description |
|---|---|
| File "<Filepath>" | Enter the filepath for a graph to be saved to. |
The Refresh option is used to re-request the graph data and display it. It does not require any parameters other than Name and AnalysisObject.
Example
A simple graph Latitude vs time
TE_Graph * Add Name "Graph1" AnalysisObject "AF385" GraphXY Segment Color "Pink" DataElement "Latitude" XIsTime
A graph with two lines of the same dimension limited to a certain time constraint
TE_Graph * Add Name "Graph2" AnalysisObject "AF385" GraphXY PointSize "Medium" Segment Color "-16181" Point "1.0" DataElement "Latitude,Longitude" Labels "Latitude,Longitude" Units "deg,deg" time constraint "run1"
A simple multigraph of three lines vs time
TE_Graph * Add Name "Graph3" AnalysisObject "AF385" Multigraph Segment color "Pink" DataElement "Latitude" Segment Color "green" Data element "Longitude" Segment color "blue" data element "Altitude" XIsTime
A graph using a color gradient and time step
TE_Graph * Add Name "Graph4" AnalysisObject "AF385" GraphXY Segment Gradient "Longitude, -2.3, -16181, -2.2, %255255000, -2.2, blue" Data element "Latitude" XIsTime Step "*/Aircraft/Target1"
A graph using scalar value and horizontal line
TE_Graph * Add Name "Graph5" AnalysisObject "AF385" GraphXY Segment color "purple" data element "BodyAspectToTarget1" XIsTIme HorizontalLine ".3, value at .3, orange"
A graph using an overlay
TE_Graph * Add Name "Graph6" AnalysisObject "AF385" GraphXY Segment color "Pink" PointSize "Micro" DataElement "Latitude" Overlay "C:\temp\overlay.txt, darkgreen, Medium, 210, Green, 100"
A multigraph with labels, units, animation line and connecting dots
TE_Graph * Add Name "Graph7" AnalysisObject "AF385" Multigraph Segment color "red" data element "Latitude" Segment color "blue" data element "Longitude" Segment color "green" data element "altitude" XIsTime Labels "Lat,Lon,Alt" Units "deg,deg,km" AnimationLine "yellow" ConnectDots "ON"
Saving a graph previously generated. (T&E 1.5)
TE_Graph * Save Name "Graph7" AnalysisObject "AF385" File "C:\temp\Graph7.png"
Creating a graph specifying SourceName and ShortName for various data elements:
TE_Graph * Add Name "Graph5" AnalysisObject "AF3_0385" GraphXY Segment Color "Yellow" DataElement "AF3_0385_MeasuredTracks_ID.csv [Track1] | NorthWestUp_X" XIsTime Segment Color "%255000000" DataElement "AF3_0385_MeasuredTracks_ID.csv [Track2] | NorthWestUp_X" XIsTime Segment Color "Blue" DataElement "AF3_0385_MeasuredTracks_ID.csv [Track3] | NorthWestUp_X" XIsTime
Creating a graph specifying the Below Color while also disabling the Above option:
TE_Graph * Add Name "Graph8" AnalysisObject "AF3_0385" GraphXY Segment Gradient "StateVector.Longitude, -2.1 rad, -16181, -119.175 deg, %255255000, -2.06, Green, -2.04, Blue" BelowColor "purple" Above "OFF" DataElement "StateVector.Latitude" XIsTime
Modifying a graph's segment color:
TE_Graph * Modify Name "Graph1" AnalysisObject "AF3_0385" Segment "1" Color "Brown"
ReturnMessage
Group Membership
This command belongs to the following group(s):
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