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.

Note: 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.
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.
NoProp If included on the command line the satellite's state will be set but it will not be propagated.

Example

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

SetState */Satellite/Satellite1 SPICE File "C:\Users\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

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

Version

10.1

STK Programming Interface 11.0.1