PositionConvert(Variable, Variable, TimeSpan, Array) Function

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)

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

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);