Documentation / @interstellar-tools/equations / axialTilt
Function: axialTilt()
ts
function axialTilt(
model: IauRotationModelInterface,
orbit: OrbitInterface,
date?: Date
): DegreesType;Defined in: cartography/axial-tilt.ts:65
The axial tilt of a body, its obliquity: the angle between its spin axis and its orbit's pole, from its IAU rotation model and its orbit.
The spin axis is the model's pole i and om, placed in the ICRF by orbitFrameToIcrf:
Notes
- Over 90°, the body spins backwards against its orbit: Venus 177.36°, Uranus 97.77°, Pluto 119.61°.
- The spin axis follows the right-hand rule, so it doesn't matter whether the model's pole is the IAU's
'north'or'positive'one. - The datasets' orbits are fixed at J2000, so the default
dateis J2000. A later date moves the pole, not the orbit. - The IAU's models of most moons assume the spin axis follows the orbit's pole, so a moon's tilt from them says how well the model fits the orbit, not what anyone measured.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
model | IauRotationModelInterface | undefined | The body's IAU rotation model, for example body.rotation.iau from a dataset. |
orbit | OrbitInterface | undefined | Its orbit, with a frame that can be placed in the ICRF. |
date? | Date | J2000_UTC | The moment to take the pole at, on or after 1972-01-01. Defaults to J2000. |
Returns
The axial tilt, from 0° to 180°.
Throws
If the model's prime meridian doesn't turn, the orbit has no frame, or one that can't be placed in the ICRF (orbitFrameToIcrf).
Example
ts
import { PLANETS } from '@interstellar-tools/constants';
const mars = PLANETS.find((planet) => planet.id === 'mars')!;
axialTilt(mars.rotation!.iau!, mars.orbit!); // ≈ 25.19See
bodyOrientation, for the pole.