Description | Example | Return Message | Group

GenerateTLE (Satellites)

Propagate a Satellite using the two line element set created from the input data.

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 two line element set from the input data and then propagate the Satellite using that two line 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, valid value is between 0 and 99999
<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: SGP4 and AFSPC_SGP4. SGP4 uses the internal SGP4 routine implemented by STK. AFSPC_SGP4 indicates the AFSPC implementation of the SGP4 routine. If no {Routine} is specified, the internal SGP4 routine will be used.

Note: 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.

Note: The AFSPC_SGP4 routine may be available as an option if STK has been properly configured to support it. It is only available if the user has 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.

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

Example

Generate a tle and use it to create the new satellite NewSat1:

GenerateTLE */Satellite/ERS1 Sampling "1 Jun 2004 12:00:00.00" "1 Jun 2004 20:00:00.00" 60.0 "1 Jun 2004 12:00:00.00" 55443 21 0.0003 SGP4 NewSat1

Generate a tle and use it to modify the ERS1 satellite:

GenerateTLE */Satellite/ERS1 Sampling "1 Jun 2004 12:00:00.00" "2 Jun 2004 12:00:00.00" 60.0 "1 Jun 2004 12:00:00.00" 55443 21 0.0003 SGP4 IntlDes GB ElemNum 3

Generate a tle and use it to modify the Satellite1 satellite:

GenerateTLE */Satellite/Satellite1 Sampling "1 Jun 2004 12:00:00.00" "1 Jun 2004 13:00:00.00" 30.0 "1 Jun 2004 12:00:00.00" 27556 20 0.0004 SGP4 BStar 0.004 Classification C

Generate a tle using the single point method:

GenerateTLE */Satellite/Satellite1 Point "1 Jun 2004 12:00:00.00" 27556 20 0.0004

Generate a tle, specifying the rev number:

GenerateTLE */Satellite/Satellite1 Sampling "1 Jul 2006 12:00:00.00" "1 Jul 2006 16:00:00.00" 30.0 "1 Jul 2006 12:00:00.00" 27556 20 0.0004 SGP4 RevNumber 456

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Object Tools

Vehicles

Version

10

STK Programming Interface 11.0.1