Skip to content

Documentation / @interstellar-tools/types / IauRotationModelInterface

Interface: IauRotationModelInterface ​

Defined in: celestial-bodies/rotation.ts:77

A body's IAU rotation model: which way its spin axis points, and how far it has turned, at any moment (Archinal et al. 2018).

INFO

  • With T in Julian centuries and d in days from J2000.0 TDB, the pole is at right ascension α0+α˙T and declination δ0+δ˙T, and the prime meridian at W=W0+W˙d+W¨d2, each plus its periodic terms.
  • W is measured east along the body's equator from where it crosses the ICRF equator northwards, at right ascension α+90°.
  • pole says which pole the model gives. For planets and their moons it's the 'north' one, on the north side of the solar system's invariable plane, so W˙ is negative for a backwards spin, like Venus's and Uranus's. For dwarf planets, asteroids and comets it's the 'positive' one, by the right-hand rule, so W˙ is always positive, and Pluto's points south.
  • The periodic terms can't be left out where they're large: they move Mars's pole by 1.6° and Triton's by 21°.

Example ​

ts
// Saturn
const saturn: IauRotationModelInterface = {
  pole: 'north',
  rightAscension: 40.589 as DegreesType,
  rightAscensionRate: -0.036,
  declination: 83.537 as DegreesType,
  declinationRate: -0.004,
  primeMeridian: 38.9 as DegreesType,
  primeMeridianRate: 810.7939024
};

Properties ​

declination ​

ts
declination: DegreesType;

Defined in: celestial-bodies/rotation.ts:85

The pole's declination at J2000.0, δ0, in degrees.


declinationRate ​

ts
declinationRate: number;

Defined in: celestial-bodies/rotation.ts:87

Its rate δ˙, in degrees per Julian century.


declinationTerms? ​

ts
declinationTerms?: readonly IauPeriodicTermInterface[];

Defined in: celestial-bodies/rotation.ts:97

Periodic terms added to the declination, each Acos⁡θ.


pole ​

ts
pole: 'north' | 'positive';

Defined in: celestial-bodies/rotation.ts:79

Which pole the model gives: 'north' for planets and moons, 'positive' by the right-hand rule for small bodies.


primeMeridian ​

ts
primeMeridian: DegreesType;

Defined in: celestial-bodies/rotation.ts:89

The prime meridian's angle at J2000.0, W0, in degrees.


primeMeridianAcceleration? ​

ts
primeMeridianAcceleration?: number;

Defined in: celestial-bodies/rotation.ts:93

Its quadratic term W¨, in degrees per day². Omitted when 0.


primeMeridianRate ​

ts
primeMeridianRate: number;

Defined in: celestial-bodies/rotation.ts:91

Its rate W˙, in degrees per day: negative for a backwards spin about a 'north' pole.


primeMeridianTerms? ​

ts
primeMeridianTerms?: readonly IauPeriodicTermInterface[];

Defined in: celestial-bodies/rotation.ts:99

Periodic terms added to the prime meridian, each Asin⁡θ.


rightAscension ​

ts
rightAscension: DegreesType;

Defined in: celestial-bodies/rotation.ts:81

The pole's right ascension at J2000.0, α0, in degrees.


rightAscensionRate ​

ts
rightAscensionRate: number;

Defined in: celestial-bodies/rotation.ts:83

Its rate α˙, in degrees per Julian century.


rightAscensionTerms? ​

ts
rightAscensionTerms?: readonly IauPeriodicTermInterface[];

Defined in: celestial-bodies/rotation.ts:95

Periodic terms added to the right ascension, each Asin⁡θ.