PositionConvert(Variable, Variable, TimeSpan, Array, Variable, Variable) Function

Top 

Description

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

 

Timing Precision Mode

This page describes functionality in nanosecond timing precision mode.

 

Function Signature

PositionConvert(

Variable fromSystem,


Variable toSystem,


TimeSpan epoch,


Array fromVector,


Variable lcsLongitude,


Variable lcsLatitude)

 

 

Arguments

fromSystem


Description:

Coordinate system of input position.

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 position.

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 position 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 three-element array containing the position in the input coordinate system.

Required Size:

At least 3

 

 

lcsLongitude


Description:

When the 'fromSystem' or 'toSystem' is Local Coordinates - Longitude or Local Coordinates - Longitude/Latitude, this argument defines the longitude of the system. If both the input and output coordinate systems are referenced to a longitude, both will be defined using this longitude.

Units:

deg

Valid Range:

-360 ≤ lcsLongitude ≤ 360

 

 

lcsLatitude


Description:

When the 'fromSystem' or 'toSystem' is Local Coordinates - Longitude/Latitude, this argument defines the latitude of that system.

Units:

deg

Valid Range:

-90 ≤ lcsLatitude ≤ 90

 

 

 

Return Value

Type:

Array of number (size = 3)

Units:

km

 

 

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

 

Syntax

myArray1 = PositionConvert(myVariable1, myVariable2, myTimeSpan1, myArray2, myVariable3, myVariable4);

 

 

See also

PositionConvert

Orbit Reference Frames