Description | Example | Return message | Group

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.

Only element sets whose SSC number uses five digits (i.e. numbers <= 99999) will be output as TLEs are restricted to five digits.

"<TLEFilePath>" is the output tle file, it should have a ".tle" or ".tce" extension. If the file exists it will be overwritten.

This command will Nack if no matches are found using the search criteria.

The {Source} can be any of the following:

{Source}Description
DefaultSatDBUse the default Satellite database file.
"<TLEFilePath>"The full path of a tle file, this file should have the extension ".tle" or ".tce".

"<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.

AGIServerIndicates 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. At least one {SearchParameters} must be entered 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. Values are entered in Connect distance units and should be between 0.0 and 999999000.0m.
Perigee <MinPer> <MaxPer>Specify the minimum and maximum search limits for perigee. Values are entered in Connect distance units and should be between 0.0 and 999999000.0m.
Period <MinPer> <MaxPer>Specify the minimum and maximum search limits for period. Values are entered in Connect time units and should be between 0.0 and 5999940.0 seconds.
Inclination <MinInc> <MaxInc>Specify the minimum and maximum search limits for Inclination. Values are entered in degrees and should be 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 whose name begins with gps, that are active and whose apogee is between 10.0km and 300000.0 km:

CreateTLEFile * DefaultSatDB "c:\MyTemp\myTCE2.tce" CommonName gps* Apogee 10.0 300000.0 Status Active

Return message

Group membership

This command belongs to the following group(s):

Scenarios

Version

11.6