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':xto the J2000 equinox,zto the ecliptic's north pole. The rotation is, with = 84 381.448″. 'equator': the ICRF itself.'laplace'and'parent-equator':xto the plane's ascending node on the ICRF equator, at right ascension, and zto its pole, as JPL's satellite mean elements count om. The rotation is.
Parameters
| Parameter | Type | Description |
|---|---|---|
frame | OrbitFrameInterface | An orbit's frame, for example body.orbit.frame from a dataset. |
Returns
The rotation matrix from the plane's coordinates to the ICRF.
Throws
- If
frameis a'laplace'or'parent-equator'plane without apole. - If
frameis'sky'or'galactic': the sky needs the direction to the system, and the galactic plane where itsomis 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 planeSee
stateAt, which uses it to place a dataset orbit in the ICRF.