AttitudeConvert(Variable, Variable, Spacecraft, Array, Variable) Function

Description

Converts the position or velocity components of from3or6Vector from the fromAttitude reference system to the toAttitude reference system, using referenceSpacecraft as the reference Spacecraft.

This overload allows you to specify whether to perform a position vector conversion or velocity vector conversion using the conversionType argument. Note that the BCS and Geodetic frames are not supported for velocity vector conversions.

Timing Precision Mode

This page describes functionality in nanosecond timing precision mode.

Function Signature

AttitudeConvert(	Variable fromAttitude,
	Variable toAttitude,
	Spacecraft referenceSpacecraft,
	Array from3or6Vector,
	Variable conversionType)

Arguments

fromAttitude

Description:

Attitude system of input state.

Valid Values:

Value	Label
0	ICRF
1	Spacecraft's current velocity-normal-binormal (VNB) reference system
2	Spacecraft's current local vertical and local horizontal (LVLH) reference system
3	Spacecraft's body coordinate system (BCS)
4	Spacecraft's current geodetic system
5	Spacecraft's current UVW reference system
6	Spacecraft's current RIC reference system

toAttitude

Description:

Attitude system of output state.

Valid Values:

Value	Label
0	ICRF
1	Spacecraft's current velocity-normal-binormal (VNB) reference system
2	Spacecraft's current local vertical - local horizontal (LVLH) reference system
3	Spacecraft's body coordinate system (BCS)
4	Spacecraft's current geodetic system
5	Spacecraft's current UVW reference system
6	Spacecraft's current RIC reference system

referenceSpacecraft
Description:	The Spacecraft object to which the attitude frames are referenced.

from3or6Vector
Description:	A three- or six-element array containing the relative position and velocity vectors relative to the origin in the input attitude system. A three-element array is for position conversions, a six-element array is required for velocity conversions.
Required Size:	At least 3

conversionType

Description:

Type of conversion to perform.

Valid Values:

Value	Label
0	Position vector conversion
1	Velocity vector conversion

Return Value

Type:

Array of number (size = 3)

Returns a three-element array containing the converted vector in the output attitude system.

Syntax

myArray1 = AttitudeConvert(myVariable1, myVariable2, mySpacecraft1, myArray2, myVariable3);