Description | Example | Return message | Group

SetState SPICE

Set the orbit state of a satellite from an SPICE file.

Syntax

SetState <SatObjectPath> SPICE <Options>

Related commands

Description

The SetState SPICE command sets the orbit state definition of the satellite using a BSP file. These are binary files that are in a standard format produced by the Jet Propulsion Laboratory (JPL). They are intended for ephemeris for celestial bodies, but you can use them for spacecraft.

For a new SPICE satellite, you must specify the File and BodyID.

You must enter at least one option on the command line. Valid <Options> are:

<Options>Description
File "<Filename>"Enter an SPICE file to be added. This option is required for a new SPICE satellite.

"<FilePath>" is the path to a file on your local drive.

BodyID <Value>Enter the satellite ID value. This option is required for new Spice satellite or if specifying a new File and the BodyID is not in new File.
TimePeriod {TimeInterval}

Enter {TimeInterval} to define the beginning and end of the satellite's time period for propagation. The interval must be within the file times. If you do not enter TimePeriod, STK will use the file times.

For valid {TimeInterval} values see Time Options.

TimeStep <StepSize>Specify the interval between calculated ephemeris output points. Enter TimeStep in seconds, greater or equal to 0.001 seconds. The default value is 60 seconds.
SegmentNumber <Value>Specify the current segment. The default value is 1.
NoPropIf you include NoProp on the command line, STK will set the satellite's state but will not propagate the satellite.

Examples

Set the state for a new satellite using the SPICE propagator:

SetState */Satellite/Satellite1 SPICE File "C:\Users\stkUser\Documents\ExternalFiles\SPICE\TestSat.bsp" BodyID 6556 SegmentNumber 1

Set the time step for the satellite, but don't propagate:

SetState */Satellite/Satellite1 SPICE TimeStep 120.0 NoProp

Return message

Group membership

This command belongs to the following group(s):

Vehicles

Version

12.10