diff --git a/.wiki/Time-Scales.md b/.wiki/Time-Scales.md index 8bef498..49aaa3e 100644 --- a/.wiki/Time-Scales.md +++ b/.wiki/Time-Scales.md @@ -8,21 +8,21 @@ Getting time right is the most error-prone part of an astronomy library. moon-si User input (Date / ISO string) │ ▼ -UTC — Coordinated Universal Time +UTC: Coordinated Universal Time │ + ΔAT (leap seconds, integer steps) ▼ -TAI — International Atomic Time +TAI: International Atomic Time │ + 32.184 s (exact, by definition) ▼ -TT — Terrestrial Time (formerly ET) +TT : Terrestrial Time (formerly ET) │ + periodic correction (~1.7 ms max) ▼ -TDB — Barycentric Dynamical Time ← used by JPL DE442S +TDB: Barycentric Dynamical Time ← used by JPL DE442S Also needed: UTC + (UT1 - UTC) ← from IERS Bulletin A ▼ -UT1 — Universal Time 1 ← used for Earth Rotation Angle +UT1: Universal Time 1 ← used for Earth Rotation Angle ``` ## UTC: Coordinated Universal Time diff --git a/CHANGELOG.md b/CHANGELOG.md index 0628f0e..99f290d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,15 +7,15 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ### Added -- `getMoonPosition(date, lat, lon, elevation?)` — topocentric Moon azimuth, altitude, distance, +- `getMoonPosition(date, lat, lon, elevation?)`: topocentric Moon azimuth, altitude, distance, and parallactic angle via Meeus Ch. 47 (no kernel required, ~0.3° accuracy) -- `getMoonIllumination(date)` — illumination fraction, phase cycle position, bright limb +- `getMoonIllumination(date)`: illumination fraction, phase cycle position, bright limb position angle, and waxing/waning flag via Meeus Ch. 47/48 (no kernel required) -- `getMoonVisibilityEstimate(date, lat, lon, elevation?)` — quick kernel-free Odeh crescent +- `getMoonVisibilityEstimate(date, lat, lon, elevation?)`: quick kernel-free Odeh crescent visibility estimate using Meeus positions; returns V parameter, zone (A-D), ARCL, ARCV, W -- `getMoon(date, lat, lon, elevation?)` — combined convenience wrapper returning phase, +- `getMoon(date, lat, lon, elevation?)`: combined convenience wrapper returning phase, position, illumination, and visibility estimate in a single call -- `phaseName` and `phaseSymbol` fields on `MoonPhaseResult` — human-readable name +- `phaseName` and `phaseSymbol` fields on `MoonPhaseResult`: human-readable name (e.g. "Waxing Crescent") and moon phase emoji (e.g. "🌒") - `MoonPosition`, `MoonIlluminationResult`, `MoonVisibilityEstimate`, and `MoonSnapshot` TypeScript types