CreateTLEFile
Creates a TLE file using satellites obtained from the Satellite database.
Syntax
CreateTLEFile <ScenarioPath> {Source} "<TLEFilePath>" [{Options}] {SearchParameters}
Related commands
Description
The CreateTLEFile command will create a TLE file using information extracted from the specified Satellite database based on the input search parameters. No Satellites are loaded as a result of this command.
This command only generates element sets with five-digit SSC numbers (i.e., numbers <= 99999), as TLEs are restricted to five digits.
"<TLEFilePath>" is the output TLE file, and it should have a ".tle" or ".tce" extension. If the file already exists, the command will overwrite it.
This command will Nack if no matches are found using the search criteria.
The {Source} can be any of the following:
| {Source} | Description |
|---|---|
| DefaultSatDB | Use the default Satellite database file. |
| "<TLEFilePath>" | Uses the full path of a TLE file, which should have the extension ".tle" or ".tce". "<FilePath>" is the path to a file on your local drive. |
| AGIServer | Indicates that the source is the AGI Server. |
The next table lists the {Options} for the TLE file. None of these options is required.
| {Options} | Description |
|---|---|
| TimePeriod {TimeInterval} | Specify the time period for TLE's added to the file.
For valid {TimeInterval} values, see Time Options. The default is to use the Scenario time period. |
The following table describes the {SearchParameters} for the Satellite database. You must enter at least one {SearchParameters} with the command. Values specified as <Name> are character values and can include a wildcard, e.g., CommonName gps*. If the desired value contains a space, then the <Name> must be enclosed in double quotes, e.g., Owner "Burkina Faso"
| {SearchParameters} | Description |
|---|---|
| SSCNumber <Value> | Specify the SSC number of the satellite. |
| CommonName <Name> | Specify the common name of the satellite. |
| OfficialName <Name> | Specify the official name of the satellite. |
| Owner <Name> | Specify the country that owns the satellite. |
| Mission <Name> | Specify the mission that the satellite performs. |
| InternationalNumber <Name> | Specify the international number of the satellite to be imported. The international number format is YYYY-DDD and an alpha indicator, if there is more than one part of the satellite. |
| Status {Active | Inactive} | Specify the status of the satellite. |
| Apogee <MinApo> <MaxApo> | Specify the minimum and maximum search limits for apogee. Enter values, in Connect distance units, between 0.0 m and 999999000.0 m. |
| Perigee <MinPer> <MaxPer> | Specify the minimum and maximum search limits for perigee. Enter values, in Connect distance units, between 0.0 m and 999999000.0 m. |
| Period <MinPer> <MaxPer> | Specify the minimum and maximum search limits for period. Enter values, in Connect time units, between 0.0 and 5999940.0 seconds. |
| Inclination <MinInc> <MaxInc> | Specify the minimum and maximum search limits for Inclination. Enter values, in degrees, between 0.0 and 180.0. |
Examples
After changing your Connect distance units to km, this command will create a file containing the TLEs for satellites with names beginning with gps that are active and with apogee between 10.0 km and 300000.0 km:
Return message
Group membership
This command belongs to the following group(s):
Version
12.10