VelocityConvert(Variable, Variable, Variable, Array, Variable) Function

Top 

Description

Converts the position and velocity specified by fromVector from the fromSystem coordinate system to a velocity in the toSystem coordinate system, referencing the coordinate systems to the specified epoch.

 

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.

 

Function Signature

VelocityConvert(

Variable fromSystem,


Variable toSystem,


Variable epoch,


Array fromVector,


Variable frameEpoch)

 

 

Arguments

fromSystem


Description:

Coordinate system of input velocity.

Valid Values:

Value

Label

1

ICRF

2

Mean of J2000 Earth Ecliptic

3

True of Date Earth Equator

4

Earth Fixed

5

Local Coordinates - Longitude

6

True Equator Mean Equinox

7

Local Coordinates - Longitude/Latitude

8

Mean of Date Earth Equator

9

Mean of 1950 Earth Equator

10

Moon Fixed (Principle Axis Rotating)

11

TIRF

12

Moon Principle Axis - Inertial at J2000

13

Moon Principle Axis - Inertial at Epoch

14

Moon Mean Earth - Rotating

15

Moon Mean Earth - Inertial at J2000

16

Moon Mean Earth - Inertial at Epoch

17

Mean of J2000 Earth Equator

18

CIRF

19

Specify any CelestialObject.ReferenceFrameId

 

 

 

toSystem


Description:

Coordinate system of output velocity.

Valid Values:

Value

Label

1

ICRF

2

Mean of J2000 Earth Ecliptic

3

True of Date Earth Equator

4

Earth Fixed

5

Local Coordinates - Longitude

6

True Equator Mean Equinox

7

Local Coordinates - Longitude/Latitude

8

Mean of Date Earth Equator

9

Mean of 1950 Earth Equator

10

Moon Fixed (Principle Axis Rotating)

11

TIRF

12

Moon Principle Axis - Inertial at J2000

13

Moon Principle Axis - Inertial at Epoch

14

Moon Mean Earth - Rotating

15

Moon Mean Earth - Inertial at J2000

16

Moon Mean Earth - Inertial at Epoch

17

Mean of J2000 Earth Equator

18

CIRF

19

Specify any CelestialObject.ReferenceFrameId

 

 

 

epoch


Description:

The TAI epoch of the input and/or output velocity in modified Julian date format. If both the input and output coordinate systems are referenced to an epoch, both will be defined using this epoch.

 

 

fromVector


Description:

A six-element array containing the position and velocity in the input coordinate system.

Required Size:

At least 6

 

 

frameEpoch


Description:

When the 'fromSystem' or 'toSystem' is Body Inertial Equatorial at Epoch, this argument defines the epoch at which the coordinate system will be evaluated. If both the input and output coordinate systems are referenced to the epoch, both will be evaluated at the same epoch.

 

 

 

Return Value

Type:

Array of number (size = 3)

Units:

km/s

 

 

Returns a three-element array containing the velocity in the output coordinate system.

 

Syntax

myArray1 = VelocityConvert(myVariable1, myVariable2, myVariable3, myArray2, myVariable4);

 

 

See also

VelocityConvert

Orbit Reference Frames