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 can be used for spacecraft.

For a new SPICE satellite the File and BodyID must be specified.

At least one option must be entered 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>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.

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 not entered file times will be used.

For valid {TimeInterval} values see Time Options.

TimeStep <StepSize>Specify the interval between calculated ephemeris output points. Entered in seconds and must be 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 included on the command line the satellite's state will be set but it will not be propagated.

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

11.5