Coordinates transformations#
- COORD_TRANS_VEC#
Generic coordinates transformation from one geophysical or heliospheric coordinate system to another.
- Inputs:
ntime (integer) – number of time points
sysaxesIN (integer) – key for the input coordinate system (see Coordinate systems)
sysaxesOUT (integer) – key for the output coordinate system (see Coordinate systems)
iyear (array of ntime integer) – the year
idoy (array of ntime integer) – the day of year (January 1st is idoy=1)
UT (array of ntime double) – the time in seconds
xIN (array of [3, ntime] double) – position in input coordinates system
- Outputs:
xOUT (array of [3, ntime] double) – position in output coordinates system
- Calling sequence:
Geographic coordinates transformations#
- GEO2GSM#
Transforms GEO to GSM coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Outputs:
psi (double) – angle for GSM coordinate
xGSM (array of 3 double) – cartesian position in GSM (Re)
- Calling sequence:
- GSM2GEO#
Transforms GSM to GEO coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGSM (array of 3 double) – cartesian position in GSM (Re)
- Outputs:
psi (double) – angle for GSM coordinate
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Calling sequence:
- GEO2GSE#
Transforms GEO to GSE coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Outputs:
xGSE (array of 3 double) – cartesian position in GSE (Re)
- Calling sequence:
- GSE2GEO#
Transforms GSE to GEO coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGSE (array of 3 double) – cartesian position in GSE (Re)
- Outputs:
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Calling sequence:
- GEO2GDZ#
- Transforms :ref:`GEO <GEO>` to :ref:`GDZ <GDZ>` coordinates.#
- Inputs:
xx (double) – xGEO (Re)
yy (double) – yGEO (Re)
zz (double) – zGEO (Re)
- Outputs:
lati (double) – latitude (deg)
longi (double) – East longitude (deg)
alti (double) – altitude (km)
- Calling sequence:
- GDZ2GEO#
- Transforms :ref:`GDZ <GDZ>` to :ref:`GEO <GEO>` coordinates.#
- Inputs:
lati (double) – latitude (deg)
longi (double) – East longitude (deg)
alti (double) – altitude (km)
- Outputs:
xx (double) – xGEO (Re)
yy (double) – yGEO (Re)
zz (double) – zGEO (Re)
- Calling sequence:
- GEO2GEI#
Transforms GEO to GEI coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Outputs:
xGEI (array of 3 double) – cartesian position in GEI (Re)
- Calling sequence:
- GEI2GEO#
Transforms GEI to GEO coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGEI (array of 3 double) – cartesian position in GEI (Re)
- Outputs:
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Calling sequence:
- GEO2SM#
Transforms GEO to SM coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Outputs:
xSM (array of 3 double) – cartesian position in SM (Re)
- Calling sequence:
- SM2GEO#
Transforms SM to GEO coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xSM (array of 3 double) – cartesian position in SM (Re)
- Outputs:
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Calling sequence:
- GSM2SM#
Transforms GSM to SM coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGSM (array of 3 double) – cartesian position in GSM (Re)
- Outputs:
xSM (array of 3 double) – cartesian position in SM (Re)
- Calling sequence:
- SM2GSM#
Transforms SM to GSM coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xSM (array of 3 double) – cartesian position in SM (Re)
- Outputs:
xGSM (array of 3 double) – cartesian position in GSM (Re)
- Calling sequence:
- GEO2MAG#
Transforms GEO to MAG coordinates.
- Inputs:
iyr (integer) – the year
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Outputs:
xMAG (array of 3 double) – cartesian position in MAG (Re)
- Calling sequence:
- MAG2GEO#
Transforms MAG to GEO coordinates.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xMAG (array of 3 double) – cartesian position in MAG (Re)
- Outputs:
xGEO (array of 3 double) – cartesian position in GEO (Re)
- Calling sequence:
- SPH2CAR#
Routine to transform spherical coordinates to cartesian.
- Inputs:
r (double) – radial distance (arbitrary unit)
lati (double) – latitude (deg)
longi (double) – East longitude (deg)
- Outputs:
x (array of 3 double) – cartesian coordinates (same unit as r)
- Calling sequence:
- CAR2SPH#
Routine to transform cartesian coordinates to spherical.
- Inputs:
x (array of 3 double) – cartesian coordinates (arbitrary unit)
- Outputs:
r (double) – radial distance (same unit as x)
lati (double) – latitude (deg)
longi (double) – East longitude (deg)
- Calling sequence:
Geographic to heliospheric and vice versa coordinates transformations#
- GSE2HEE#
Routine to transform geocentric coordinates GSE to heliospheric coordinates HEE (Heliocentric Earth Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE)).
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xGSE (array of 3 double) – cartesian position in GSE (Re)
- Outputs:
xHEE (array of 3 double) – cartesian position in HEE (AU)
- Calling sequence:
- HEE2GSE#
Routine to transform heliospheric coordinates HEE (Heliocentric Earth Ecliptic, also sometime known as Heliospheric Solar Ecliptic (HSE)) to geocentric coordinates GSE.
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xHEE (array of 3 double) – cartesian position in HEE (AU)
- Outputs:
xGSE (array of 3 double) – cartesian position in GSE (Re)
- Calling sequence:
Heliospheric coordinates transformations#
- HEE2HAE#
Routine to transform heliospheric coordinates HEE (Heliocentric Earth Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE)) to heliospheric coordinates HAE (Heliocentric Aries Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE))
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xHEE (array of 3 double) – cartesian position in HEE (AU)
- Outputs:
xHAE (array of 3 double) – cartesian position in HAE (AU)
- Calling sequence:
- HAE2HEE#
Routine to transform heliospheric coordinates HAE (Heliocentric Aries Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE)) to heliospheric coordinates HEE (Heliocentric Earth Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE))
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xHAE (array of 3 double) – cartesian position in HAE (AU)
- Outputs:
xHEE (array of 3 double) – cartesian position in HEE (AU)
- Calling sequence:
- HAE2HEEQ#
Routine to transform heliospheric coordinates HAE (Heliocentric Aries Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE)) to heliospheric coordinates HEEQ (Heliocentric Earth Equatorial also sometime known as Heliospheric Solar (HS))
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xHAE (array of 3 double) – cartesian position in HAE (AU)
- Outputs:
xHEEQ (array of 3 double) – cartesian position in HEEQ (AU)
- Calling sequence:
- HEEQ2HAE#
Routine to transform heliospheric coordinates HEEQ (Heliocentric Earth Equatorial also sometime known as Heliospheric Solar (HS)) to heliospheric coordinates HAE (Heliocentric Aries Ecliptic also sometime known as Heliospheric Solar Ecliptic (HSE))
- Inputs:
iyr (integer) – the year
idoy (integer) – the day of year (January 1st is idoy=1)
UT (double) – the time in seconds
xHEEQ (array of 3 double) – cartesian position in HEEQ (AU)
- Outputs:
xHAE (array of 3 double) – cartesian position in HAE (AU)
- Calling sequence: