GenerateTLE (Satellites)
Propagate a satellite using SGP4 with the computed best-fit GP data set to the ephemeris of an existing satellite.
Syntax
GenerateTLE <SatObjectPath> {Method} [{TimeInterval} <TimeStep>] "<TLEEpoch>" <SSCNumber> <MaxIterations> <Convergence> [{Routine}] [<NameOfNewSatellite>] [IntlDes <IntlDesignator>] [ElemNum <ElementNumber>] [BStar <BStarValue>] [Classification <Class>] [RevNumber <Value>]
Description
The GenerateTLE command will create a GP element set that is the best-fit to the satellite's ephemeris in an RMS sense. It then creates a new satellite by the specified name and propagates it with the SGP4 using that element set.
The following table describes the parameters for this command. The Required column indicates which parameters are required and which are not.
| Parameters | Required | Description |
|---|---|---|
| {Method} | Yes | Valid values are Sampling and Point. |
| {TimeInterval} <TimeStep> | Depends on {Method} | These values are required if {Method} is Sampling. If {Method} is Point, do not enter these values. For valid {TimeInterval} values, see Time Options. <TimeStep> must be in seconds and greater than or equal to 1.0. {TimeInterval} must be within the time period of the Satellite specified by <SatObjectPath>. |
| {TLEEpoch} | Yes | If {Method} is Sampling, then {TLEEpoch} must be within the {TimeInterval}. If {Method} is Point, then {TLEEpoch} must be within the Satellite's time period.
For valid {TLEEpoch} values, see Time Options. |
| <SSCNumber> | Yes | An integer value between 0 and 999,999,999. |
| <MaxIterations> | Yes | Enter the maximum number of successive iterations that STK is allowed to compute to achieve convergence. This is an integer value between 1 and 10000. |
| <Convergence> | Yes | Enter a real number between 0.01 and 0.0000000001. |
| {Routine} | No | Valid values for {Routine} are: Default, SGP4, or the name of an installed SGP4 plugin routine, e.g., ASTROSTDS_SGP4_V9. The value Default accepts the SGP4 routine set in Edit -> Preferences.
If the SGP4 routine supports SGP4-XP, you need to add the keyword UseSGP4XP with possible values Yes/On/True or No/Off/False. The internal SGP4 routine does not support the SGP4-XP, but an Astro Standards plugin routine does. 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 a minor install procedure. Contact Support for more information. In the past you may have used the {Routine} parameter to choose the USGovMSGP4 routine. This is no longer necessary, as the implementation of the internal SGP4 routine and the USGov routine have been made the same. |
| <NameOfNewSatellite> | No | If you enter this, then STK will create a new Satellite with the basic properties of the TLE generated. If you don't specify <NameOfNewSatellite>, STK will modify the satellite specified by <SatObjectPath>. |
| IntlDes <IntlDesignator> | No | You can specify an international designator that is 1 to 11 characters. |
| ElemNum <ElementNumber> | No | Enter an integer value. |
| BStar <BStarValue> | No | <BStarValue> is a real number between -1.0 and 1.0. If you enter this parameter, then Solve For Drag (for the Satellite) is set to Off, and STK uses the BStar value. |
| Classification <Class> | No | <Class> is a single character used to specify classification. It can be U (unclassified), S (secret), or a user-defined character. |
| RevNumber <Value> | No | Specify the rev number as an integer between 0 and 99999. |
Examples
Generate a TLE and use it to create the new satellite NewSat1:
Generate a TLE and use it to modify the ERS1 satellite:
Generate a TLE and use it to modify the Satellite1 satellite:
Generate a TLE using the single point method:
Generate a TLE, specifying the rev number:
Return message
Group membership
This command belongs to the following group(s):
Version
10