Description | Example | Return Message | Group

SetState SP3

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

Syntax

SetState <SatObjectPath> SP3 <Options>

Related Commands

Description

The SetState SP3 command sets the orbit state definition of the satellite using .sp3 files of type 'a' and 'c' and allows you to use multiple files in sequence. These files are used to provide precise GPS orbits from the National Geodetic Survey (NGS).

At least one option must be entered on the command line. Valid <Options> are:

Note: For a new SP3 satellite at least one file must be added and SatID must be specified.

<Options> Description
AddFile "<Filename>" Enter an SP3 file to be added. This option can be entered more than once on a command line.
RemoveFile "<Filename>" Enter an SP3 file to be removed. This option can be entered more than once on a command line.

The SP3 satellite must have at least one file defined, the RemoveFile option will Nack if asked to remove the last file.

SatID <Value> Enter the satellite ID value. The SatID is an alphanumeric value that must match a satellite ID in the file.
InterpOrder <value> Enter a value representing the interpolation order. The value must be an integer between 1 and 13.
InterpMethod {Lagrange | Hermitian} Enter the interpolation method. The default value is Lagrange.

InterpMethod Hermitian is only valid if all files are configured to use it (i.e. they all have velocity natively in the file).

InterpAcrossBoundaries {Yes | No} If Yes is entered, STK will interpolate ephemeris steps according to the user-defined Step Size between the end of one SP3 file and the beginning of the next; otherwise, the step between two files will simply be the time between their last and first points.
Extrapolate {Yes | No} If Yes is entered, STK will calculate an additional ephemeris step beyond the last data point provided by the SP3 file(s) assigned to the satellite.
NoProp If included on the command line the satellite's state will be set but it will not be propagated.
Reload Refresh the SP3 files. This option is not valid with any other option. The satellite must be using the SP3 propagator.

AddFile and RemoveFile can be entered multiple times on a command line. If both options appear on one command line, the RemoveFile entries will be processed first.

Example

Set the state, and options, for a satellite using the SP3 propagator:

SetState */Satellite/sp3 SP3 AddFile "C:\Users\Documents\ExternalFiles\SP3\jpl14804.sp3" SatID G06

SetState */Satellite/sp3 SP3 InterpOrder 6 InterpAcrossBoundaries No Extrapolate No

SetState */Satellite/sp3 SP3 SatID G10

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