ExternalData
Allow for the association and management of time ordered data computed outside of STK with STK objects.
Syntax
ExternalData <ObjectPath> {DataOption} [<Parameters>]
Description
The purpose of this command is to allow for the association and management of time ordered data computed outside of STK with STK objects. Data associated with STK objects via the ExternalData command can be accessed through the normal STK data providing mechanism and is therefore available for use in reporting, graphing, dynamic displays, strip charts and data displays in the 3D graphics window. This command is useful for the real time display of telemetry information on the 3D graphics window.
The ExternalData command adds the information that you provide under a Data Provider called 'User Supplied Data'. Go to Object Tools -> Report, and click the 'New' button to see the Data Provider list and create a new report style that contains your custom data.
| {DataOption} | <Parameters> | Description |
|---|---|---|
| AddGroup | "<GroupName>" <NumberOfVariables> ("<VariableName>" "<Dimension>") ... |
Create a new time ordered data group to the specified object. A data group is set of time dependent variables that will all be set at the same time.
A <GroupName> must be specified along with the <NumberOfVariables> in the group. Paired <VariableName> and <Dimension> values follow. <VariableName> and <Dimension> must be enclosed in quotes if there are spaces in their names.
The list of available <Dimensions> may be taken from the SetGUIUnits command. All variables in a data group are required to be set at the same time.
To create a <Variable> of string data, use "Char" for the <Dimension>. If your data is unitless, use "Custom" for the Dimension in the VariableName-Dimension pair, and use "" (an empty string) for the "<UnitAbbr>" in the SetInputUnit {DataOption} (below). |
| AddData | "<GroupName>" "{TimeValue}" <Variable> <Variable2> ... | Adds an additional entry into the time ordered Table of data for the specified data group. The data group must already have been created. All variables in the data group must be given a value and the order of those values must be the same as used in the creation of the data group.
For valid {TimeValue} values see Time Options. For a variable whose dimension is Char, the value must be entered in quotes: "<Variable>" The <Variables> entered must be valid values based on the unit selected. If the unit conversion can not be completed successfully, the command will Nack. |
| ReadFile | "<FilePath>" [Save | NoSave] | Read in data groups from the specified External Data file. External Data files must follow the appropriate format for compatibility with STK; refer to the STK desktop application help for information about proper file formatting. By default, data read in from a file is not saved with STK object, but this behavior is subject to explicit override by specifying either the Save or NoSave optional keywords. |
| DeleteGroup | "<GroupName>" | Deletes the specified data group and all data contained therein. |
| FlushGroup | "<GroupName>" | Removes all data entries from the specified data group, but leaves the definition of the group intact. |
| ReferenceEpochFormat | "<ReferenceEpochFormat>" | Allows a format other than UTCG to specify the epoch. Without this keyword, the ReferenceEpoch is assumed to be UTCG. |
| SetInterpOrder | "<GroupName>" "<VariableName>" <InterpOrder> | Sets the interpolation order for the specified variable in the specified data group. The default is 1st order interpolation. |
| SetInputUnit | "<GroupName>" ("<VariableName>" "<UnitAbbr>") ... |
Sets the input unit(s) for the dimension of the specified variable in the specified data group. The unit specification is done using the unit abbreviation strings used in the STK GUI. The set of available abbreviation strings for a given dimension are outlined in the SetGUIUnits command. If a dimension is compound, such as the "Rate" dimension, then the units for each sub-dimension are specified in separate commands, see example below.
Available compound dimensions include:
If your data is unitless or character data, use "" (an empty string) for the "<UnitAbbr>". |
| SetThinningInterval | "<GroupName>" <TimeStep> | Sets the data thinning parameter for the specified data group. This parameter dictates minimum number of seconds which must elapse between the time stamps of incoming data sets before the new data is permanently stored. The last data set is always stored when thinning is used, but may be deleted when a new data set comes in. The default thinning interval is zero, meaning that all incoming data is retained. |
The <VariableName>, <Dimension> and <UnitAbbr> values must be enclosed in quotes only if there are spaces in their names.
Examples
The following examples pertain to unitless data:
The following examples create and fill a data group that contains character data:
Return message
Group membership
This command belongs to the following group(s):
Version
10