Description | Example | Return Message | Group

SetPropagator File

Define a vehicle (any type) using an external file

Syntax

SetPropagator <ObjectPath> File {Propagator} "<FilePath>" [{NoProp | {TimeInterval}}]

Description

The SetPropagator command loads an element set and path definition from the specified external propagator file. The user can specify a vehicle definition and insert that into the vehicle path. Propagator files must end with a .pg extension.

{Propagator} can be TwoBody, J2Perturbation, J4Perturbation, SimpleAscent, Ballistic, GreatArc, HPOP, STKExternal, LOP, SPICE, RealTime, Astrogator, SGP4, or any other propagator that is installed for use with STK, indicated by name.

The vehicle will be propagated using the times in the specified external propagator file, unless one of the following is entered.

If NoProp is entered then the vehicle won't be propagated.

If {TimeInterval} is entered then the time interval will be used to propagate the vehicle. For valid {TimeInterval} values see Time Options.

Warning: {Propagator} names are case sensitive.

Hint: For more information about formatting an external propagator file, and examples, see the STK Help topic on Custom File Formats - Great Arc if {Propagator} is GreatArc; or Custom File Formats - Propagator for all other values of {Propagator}.

Example

To set the state of the Cruise ship using the GAFile1.pg file:

SetPropagator */Ship/Cruise File GreatArc "C:\stk\User\Data\GAFile1.pg"

To set the state of Satellite2 using the Satellite2.pg file, and only propagate for 6 hours:

SetPropagator */Satellite/Satellite2 File HPOP "C:\stk50DB\susan\Satellite2.pg" "1 Jun 2004 18:00:00.00" "2 Jun 2004 00:00:00.00"

To set the state of Satellite2 using the Satellite2.pg file, but don't propagate:

SetPropagator */Satellite/Satellite2 File HPOP "C:\stk50DB\susan\Satellite2.pg" NoProp

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10

STK Programming Interface 11.0.1