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.
Specify the name of the TLE file (*.tle or *.tce) that you wish to import satellites from using the "<FilePath>" parameter. You must enter the complete path and filename and enclosed them 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 STK loads all satellites in the file (except duplicates).
Valid {ImportOptions} and associated <Value> are:
| {ImportOption} | <Value> | Description |
|---|---|---|
| SSCNumber | <SSCNumber> | STK loads satellites matching the <SSCNumber> specified. You can enter this option two or more times on one command line. |
| Satellite | <TruncObjectPath> | Load the specified TLE set into the satellite specified by <TruncObjectPath>. If you include the Satellite option, you must also enter the SSCNumber, and the Satellite specified must already exist in the current scenario. If you enter two or more SSCNumbers, 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 you include it, 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. ASTROSTDS_SGP4_V9.
Astro Standards routines may be available as an option if you have properly configured STK to support it. It is only available if you have obtained the official SGP4 DLL (and related files) from USSF (US Space Force) and performed some minor install procedure. STK provides an interface to the USSF SGP4 routines; contact customer support for more information. | |
| 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 you enter two or more SSCNumbers 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:
To set the routine to preinstalled STK SGP4:
Return message
Group membership
This command belongs to the following group(s):
Version
11.5