ImportTLEFile (Satellites)
Import satellite(s) from TLE data
Syntax
ImportTLEFile <ScenarioPath> "<FilePath>" [{ImportOption} <Value> {ImportOption} <Value>...]
Related commands
Description
The ImportTLEFile Connect command imports satellites from a TLE file into the active scenario.
The name of the TLE file (*.tle or *.tce), that you wish to import satellites from, is specified using the "<FilePath>" parameter. The complete path and filename must be entered and enclosed in quotes.
"<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.
If you do not specify any {ImportOption}, then all satellites in the file (except duplicates) are loaded.
Valid {ImportOptions} and associated <Value> are:
| {ImportOption} | <Value> | Description |
|---|---|---|
| SSCNumber | <SSCNumber> | Satellites matching the <SSCNumber> specified will be loaded. This option can be entered multiple times on one command line. |
| Satellite | <TruncObjectPath> | Load the specified TLE set into the satellite specified by <TruncObjectPath>. If the Satellite option is included, the SSCNumber must also be entered, and the Satellite specified must already exist in the current scenario. If multiple SSCNumbers are entered then the Satellite option is invalid. All TLEs found in the file for the SSCNumer are loaded into the scenario. |
| AutoPropagate | On | Ephemeris is propagated using the scenario Time Period (or the period set by the StartStop {ImportOption} if it is included) and the SGP4 propagator. |
| Off | ||
| TimeStep | <StepSize> | Enter a value representing the interval between calculated ephemeris output points in seconds. Using this option will also turn on AutoPropagate. |
| StartStop | {TimeInterval} | Define the beginning and end of the satellite's time period. Using this option will also turn on AutoPropagate.
For valid {TimeInterval} values see Time Options. |
| Constellation | <ConstellationName> | STK creates a constellation (if it doesn't already exist) and places all of the selected satellites in it. |
| NameStyle {SSCNumber | PrefixSSCNumber <prefix> | SSCNumberSuffix <suffix>} | The default is PrefixSSCNumber with a default prefix being "tle-". This option determines the naming convention used when creating satellites. For example, using PrefixSSCNumber SSC- for ISS produces the name SSC-25544. | |
| Merge | On | Only one (1) satellite is created for each SSC number. Satellites are loaded with all TLEs within the file matching its SSC Number. |
| Off | Each TLE within the file creates a new satellite that contain only that one TLE; even if multiple TLEs with the same SSC number are present in the file. | |
| Routine {SGP4 | Default | <Name>} | Specify the implementation of the SGP4 propagator to be used, where SGP4 is the internal SGP4 routine implemented by STK, Default is the propagator selected in the Edit Preferences panel, and <Name> is an installed SGP4 plugin routine, e.g. AFSPC_SGP4_V8.
The AFSPC_SGP4 routine may be available as an option if STK has been properly configured to support it. It is only available if you have obtained the official SGP4 dll (and related files) from AFSPC (Air Force Space Command) and performed some minor install procedure. STK provides an interface to the AFSPC SGP4 routine - contact customer support. | |
| OutOfDateDuration {<valueInDays> | Off} | This option requires the GP element sets to have an epoch not earlier than the duration before the propagation start interval or after the propagation stop interval. |
If multiple SSCNumbers entered and one is invalid, a warning message will appear in the message viewer, but other SSCNumbers will be created and the command will Ack.
Examples
To load all satellites in the interest.tce TLE file, propagate their orbits and create a single constellation that includes all satellites contained in that TCE file:
To select the TLE set with the SSCNumber 21897 from the molniyaMult.tce file and merge them into one satellite:
To load three SSC numbers (creating a new satellite for each SSC number) from the file: stkSatDbAll.tce, propagate them and put them in a constellation:
The end of this command uses SGP4. You can also use Default or AFSPC_SGP4_V8:
Return message
Group membership
This command belongs to the following group(s):
Version
11.5