RelativeMotionUtilities.ComputeStateHCW(Array, Variable, Variable, Variable, Variable) Method

Top 

Description

Predicts a future position and velocity by evaluating the HCW equations using the specified primary satellite mean motion, relative state vector of the secondary satellite in units of km and km/s, and time interval deltaT. This overload assumes the Earth is the central body. The inputOutputSystem argument specifies the coordinate system of both the input and output relative states. The coordinateSetToPropagate argument is used to specify whether the HCW equations of motion are propagated using the Cartesian, RIC Cylindrical, or RIC Spherical relative state vector. The output state will be returned in units of km and km/s

 

Timing Precision Mode

This page describes functionality in millisecond timing precision mode. Millisecond timing precision mode is deprecated and will be removed in a future release. We recommend that you migrate your Mission Plans to nanosecond timing precision mode.

Click here to see the documentation for this object in nanosecond timing precision mode.

 

Method Signature

RelativeMotionUtilities.ComputeStateHCW(

Array relativeSecondaryState,


Variable primaryMeanMotion,


Variable deltaT,


Variable inputOutputSystem,


Variable coordinateSetToPropagate)

 

 

Arguments

relativeSecondaryState


Description:

Array containing the relative state of the Secondary, in relation to the Primary.

Required Size:

6

 

 

primaryMeanMotion


Description:

The mean motion of the Primary to which the state will be evaluated.

Units:

rad/s

Valid Range:

primaryMeanMotion ≥ 0

 

 

deltaT


Description:

The time interval at the end of which the state will be evaluated.

Units:

s

 

 

inputOutputSystem


Description:

The coordinate system of both the input and output relative states.

Valid Values:

Value

Label

1

VNB

2

LVLH

6

RIC

7

LVC (Cylindrical)

8

RIC Cylindrical

9

RIC Spherical

 

 

 

coordinateSetToPropagate


Description:

The coordinate system in which to propagate.

Valid Values:

Value

Label

0

RIC Cartesian

1

RIC Cylindrical

2

RIC Spherical

 

 

 

 

Return Value

Type:

Array of number (size = 6)

 

 

Returns the predicted future position and velocity of a secondary Spacecraft.

 

Syntax

myArray1 = RelativeMotionUtilities.ComputeStateHCW(myArray2, myVariable1, myVariable2, myVariable3, myVariable4);

 

 

See also

RelativeMotionUtilities Object

RelativeMotionUtilities.ComputeStateHCW