Documentation / @interstellar-tools/types / RotationInterface
Interface: RotationInterface
Defined in: celestial-bodies/rotation.ts:154
How a star, planet, moon, asteroid or comet spins: its sidereal rotation period, one turn against the stars.
INFO
- Direction: like an orbit's,
periodis always a positive duration. A backwards spin, against its parent's, hasretrograde: true: Venus, Uranus and Pluto against the Sun's spin, and Triton, which keeps one face to Neptune on its backwards orbit. A star's direction is mostly unknown, so it's left out. - Synchronous: a moon that keeps one face to its planet, like the Moon, has
synchronous: true. Itsperiodis its orbital period, and itsretrogradeis its orbit's. - Differential rotation: a ball of gas, like the Sun, turns faster at its equator than at its poles.
periodis then its reference period, the one its coordinates turn with (the Carrington period for the Sun), andequatorialPeriodandpolarPeriodgive the range. - Tumbling: a body with no fixed spin axis, like Halley's comet, has
tumbling: true, andperiodis the main period of its motion. - Axial tilt:
obliquityis the angle between its spin axis and its orbit's pole: Earth's 23.44° gives it seasons, and Venus's 177.36° is why it spins backwards. - Orientation:
iauis its IAU rotation model, the direction of its pole and its prime meridian at any moment. - Not a day: one turn against the stars is not sunrise to sunrise. The body moves along its orbit as it turns, so a solar day also depends on the orbital period: Earth turns in 23 h 56 m, and its day is 24 h.
Example
const mars: RotationInterface = {
period: { value: 24.623, unit: 'h' }
};
const moon: RotationInterface = {
period: { value: 27.321661, unit: 'd' },
synchronous: true
};
const venus: RotationInterface = {
period: { value: 243.0226, unit: 'd' },
retrograde: true
};
const sun: RotationInterface = {
period: { value: 25.38, unit: 'd' },
equatorialPeriod: { value: 24.47, unit: 'd' },
polarPeriod: { value: 34.16, unit: 'd' }
};Properties
equatorialPeriod?
equatorialPeriod?: TemporalInterface;Defined in: celestial-bodies/rotation.ts:162
Sidereal period at the equator, for a body that turns faster there than at its poles.
iau?
iau?: IauRotationModelInterface;Defined in: celestial-bodies/rotation.ts:173
Its IAU rotation model, where the IAU gives one.
obliquity?
obliquity?: DegreesType;Defined in: celestial-bodies/rotation.ts:171
Axial tilt: the angle between its spin axis, by the right-hand rule, and its orbit's pole, from 0° to 180°. Over 90° for a backwards spin.
period
period: TemporalInterface;Defined in: celestial-bodies/rotation.ts:156
Sidereal rotation period, always positive. See retrograde for the direction.
polarPeriod?
polarPeriod?: TemporalInterface;Defined in: celestial-bodies/rotation.ts:164
Sidereal period at the poles, for a body that turns slower there than at its equator.
retrograde?
retrograde?: boolean;Defined in: celestial-bodies/rotation.ts:158
true for a spin against the parent's. Omitted for the usual prograde spin.
synchronous?
synchronous?: boolean;Defined in: celestial-bodies/rotation.ts:160
true for a moon that keeps one face to its planet. Omitted otherwise.
tumbling?
tumbling?: boolean;Defined in: celestial-bodies/rotation.ts:166
true for a body with no fixed spin axis. period is then the main period of its motion.