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> is entered in seconds and must be 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 | The maximum number of successive iterations that can be computed to achieve convergence. This is an integer value between 1 and 10000 |
| <Convergence> | Yes | A real number between 0.01 and 0.0000000001 |
| {Routine} | No | Valid values for {Routine} are: Default, SGP4 and AFSPC_SGP4. 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 the AFSCPC_SGP4_V8 routine does. 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 the minor install procedure. See the "STK and SGP4 FAQ" from the www.agi.com. 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 entered 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 which is 1 to 11 characters. |
| ElemNum <ElementNumber> | No | An integer value. |
| BStar <BStarValue> | No | <BStarValue> is a value between -1.0 and 1.0. If this parameter is entered then Solve For Drag (for the Satellite) is set to Off, and the BStar value is used. |
| 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