Set the orbit state of a satellite or missile using spherical coordinates
SetState <VehObjectPath> Spherical {Propagator} {NoProp | {TimeInterval}} <StepSize> {CoordSystem} "<OrbitEpoch>" <RightAscension> <Declination> <Radius> <HorizontalFlightPathAngle> <FlightPathAzimuth> <Velocity> ["<CoordEpoch>"]
The SetState Spherical command sets the orbit state of the specified satellite or missile and propagates the orbit over the specified time period. The propagated ephemeris data is spaced by the <StepSize> parameter.
Note: The SetState Spherical command is valid for Satellite and Missile only.
| Parameter | Description |
|---|---|
| {Propagator} | This parameter is case sensitive and
the Propagator name must match the format used in the Satellite's
Orbit page or Missile's Trajectory page under Basic properties.
Valid values for Satellite are TwoBody, J2Perturbation, J4Perturbation, HPOP and LOP. Valid values for Missile are TwoBody and HPOP. |
| {NoProp | {TimeInterval}} |
Enter NoProp to set the state of the vehicle but not propagate it. Enter {TimeInterval} to define the beginning and end of the satellite's time period for propagation. For valid {TimeInterval} values see Time Options. |
| <StepSize> | Entered in seconds and must be greater
or equal to 0.001 seconds.
Note: If LOP propagator is selected, the <StepSize> must be greater or equal to one day (86164.09 seconds). |
| {CoordSystem} | This parameter is case sensitive and the CoordSystem name must match the format used in the Orbit page of the vehicle's Basic properties. Valid Values are Fixed, ICRF, J2000, MeanOfDate, MeanOfEpoch, TrueOfDate, TrueOfEpoch, B1950, TEMEOfDate, TEMEOfEpoch, AlignmentAtEpoch. |
| "<OrbitEpoch>" | For valid "<OrbitEpoch>" values see Time Options. |
| <RightAscension> | Entered in degrees. |
| <Declination> | Entered in degrees. |
| <Radius> | Entered in Connect distance units. |
| <HorizontalFlightPathAngle> | Entered in degrees. |
| <FlightPathAzimuth> | Entered in degrees. |
| <Velocity> | Entered in Connect distance units over Connect time units. |
| ["<CoordEpoch>"] | This parameter is only applicable, and
is required, for {CoordSystem} based on an Epoch, such as
MeanOfEpoch, TrueOfEpoch, TEMEOfEpoch and AlignmentAtEpoch.
For valid "<CoordEpoch>" values see Time Options. |
Note: This command doesn't accept values of less than -180 degrees for orbital elements.
Propagator-specific parameters stored with the vehicle instance aren't affected. For example, when the SetState Spherical command is received and an HPOP {Propagator} is specified, the existing HPOP force model data is used. If you create a vehicle and modify the force model, or load a vehicle with a modified force model, that data isn't modified by this command. If a new vehicle is created via the Connect New Command, the default force model data is used.
Warning: The STK orbit propagator doesn't completely validate the correctness of the complete Orbit State specified. This means that Connect may return a positive acknowledgment when the orbit track can't be displayed. Connect performs the same validation that occurs from the entry of state data via the user interface.
To set the path for the ERS1 satellite using spherical elements and propagate the orbit:
SetState */Satellite/ERS1 Spherical J4Perturbation "1 Oct 1999 00:00:00.00" "30 Nov 1999 00:00:00.00" 60.0 J2000 "1 Oct 1999 00:00:00.00" 69.78 -63.4 6778.0 0.0 90.0 9.27
To set the path for Satellite2 satellite using spherical elements and propagate the orbit:
SetState */Satellite/Satellite2 Spherical LOP "1 Oct 1999 00:00:00.00" "30 Nov 1999 00:00:00.00" 86164.1 J2000 "1 Oct 1999 00:00:00.00" 269.29 0 42164.165 0.0 90.0 3.074
To set the state for Missile1 using Spherical coordinates and the TwoBody propagator:
SetState */Missile/Missile1 Spherical TwoBody "1 Jul 2005 12:00:00.00" "1 Jul 2005 12:00:00.00" 60.0 J2000 "1 Jul 2005 12:00:00.00" 1.737781 0.00004837 6378137.000000 1.059990 0.912139 6164.537973
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1