A TypeScript library for astronomical calculations including the position of the Sun, Moon, and planets, sunrise and sunset times, solar eclipses, and satellite positions from TLEs. Most calculations are based on Jean Meeus' Astronomical Algorithms and the VSOP87 theory.
@astronomy-bundle/core@astronomy-bundle/earth@astronomy-bundle/moon@astronomy-bundle/sun@astronomy-bundle/planets@astronomy-bundle/solar-eclipse@astronomy-bundle/lunar-limb-profile@astronomy-bundle/satellite
| Package | Description | Docs |
|---|---|---|
| Time | The TimeOfInterest object — the central time representation for all calculations. Supports Julian Day, sidereal time, Delta T, and more. |
README |
| Location | The Location object — a geographic coordinate container with formatting and distance helpers. |
README |
| Earth | The Earth object — heliocentric VSOP87 coordinates, nutation, and obliquity of the ecliptic. |
README |
| Moon | The Moon object — geocentric coordinates, apparent and observed topocentric coordinates, rise, transit and set times, phase angle, illuminated fraction, upcoming lunar phases, and apparent magnitude. |
README |
| Sun | The Sun object — geocentric coordinates, apparent and observed topocentric coordinates, rise, transit and set times, angular diameter, light time, and apparent magnitude. |
README |
| Planets | The Mercury, Venus, Mars, Jupiter, Saturn, Uranus, and Neptune objects — heliocentric, geocentric, apparent, and topocentric planetary coordinates, rise, transit and set times, plus distance, light time, phase, elongation, and magnitude. |
README |
| Solar Eclipse | Solar eclipse calculations from Besselian elements — global circumstances (eclipse type, time and location of greatest eclipse, magnitude, obscuration, Moon/Sun ratio, and the central line path) and local circumstances for any observer (local type, contact times, magnitude, obscuration, duration, and the Sun's position at a given moment). Ships with built-in catalogues covering 1900–2100 and −1999–3000. | README |
| Lunar Limb Profile | The LunarLimbProfile object — height of the Moon's visible limb silhouette from LOLA/LDEM terrain data, evaluated in perspective from the observer's distance at a celestial position angle. Useful for occultations, grazing occultations, and Baily's beads. |
README |
| Satellite | The Satellite object — created from a two-line element set (TLE), exposing all parsed orbital elements, with SGP4/SDP4 propagation to geocentric, geographic, and topocentric coordinates, velocity and Doppler shift, ground tracks, footprints, and sunlight and visibility checks. |
README |