Skip to content

Documentation / @interstellar-tools/equations / orbitFrameToIcrf

Function: orbitFrameToIcrf() ​

ts
function orbitFrameToIcrf(frame: OrbitFrameInterface): Matrix3x3Type;

Defined in: orbits/orbit-frame-to-icrf.ts:56

The rotation from an orbit's reference plane to the ICRF, the J2000 equator and equinox: multiply a vector in the plane's coordinates by it to get the vector in the ICRF.

In the plane's coordinates, x points to where the plane's om is counted from, and z to the plane's pole:

  • 'ecliptic': x to the J2000 equinox, z to the ecliptic's north pole. The rotation is R1(ε), with ε = 84 381.448″.
  • 'equator': the ICRF itself.
  • 'laplace' and 'parent-equator': x to the plane's ascending node on the ICRF equator, at right ascension α+90°, and z to its pole (α,δ), as JPL's satellite mean elements count om. The rotation is R3(α+90°)R1(90°−δ).

Parameters ​

ParameterTypeDescription
frameOrbitFrameInterfaceAn orbit's frame, for example body.orbit.frame from a dataset.

Returns ​

Matrix3x3Type

The rotation matrix from the plane's coordinates to the ICRF.

Throws ​

  • If frame is a 'laplace' or 'parent-equator' plane without a pole.
  • If frame is 'sky' or 'galactic': the sky needs the direction to the system, and the galactic plane where its om is counted from, which the datasets don't give yet.

Example ​

ts
import { MOONS } from '@interstellar-tools/constants';
import { applyMatrix3, orbitFrameToIcrf } from '@interstellar-tools/equations';

const titan = MOONS.find((moon) => moon.id === 'titan')!;
const toIcrf = orbitFrameToIcrf(titan.orbit.frame!);

applyMatrix3(toIcrf, [0, 0, 1]); // ≈ [0.084, 0.062, 0.995]: the pole of Titan's Laplace plane

See ​

stateAt, which uses it to place a dataset orbit in the ICRF.