Astronomy / Specifications / QP-ASTRO-001
SYSTEM PAPER · QP-ASTRO-001 · VERSION 1.0.0

Layered Celestial Ephemeris Provider Architecture, Planetary Reductions, and Level-3 Accuracy Audit Standards

Kiến trúc hệ thống tính toán thiên văn ephemeris, mô hình quy chiếu tọa độ hành tinh và chuẩn kiểm định độ chính xác Level-3 Quizzman
Quizzman Astronomy & Research Team (Quizzman Research Lab) · 1 October 2026 · Version 1.0.0 · ● Stable

Abstract

Background / Context: Modern celestial positioning systems, planetary ephemerides, and astronomical calendrics require strict integration between classical analytical perturbation theories and high-precision numerical orbit integrations. In distributed, real-time computational services, reliance solely on monolithic numerical kernel files (such as the JPL DE series) creates latency during cold-start cycles and limits evaluation outside the designated temporal span. Conversely, abridged analytical formulas (such as truncated Jean Meeus algorithms) suffer from noticeable positional errors at cardinal equinoxes and lunation boundaries.

Methodology: This paper presents the layered architecture of the @quizzman/qm-astro computational ephemeris engine version 0.1.0, combining a dual-backend strategy: a numerical NASA JPL DE440 SPK kernel (binary DAF/Chebyshev format) alongside full analytical series for VSOP87D (Bretagnon and Francou) and lunar theory ELP/MPP02 (Chapront and Francou). The architecture introduces an autonomous CompositeProvider orchestrator, integrates continuous Terrestrial Time (TT/TDB) conversions via Espenak-Meeus polynomial splines overlaid with empirical IERS finals2000A Earth Orientation Parameters, and reduces apparent positions using the IAU 2000B nutation model, annual stellar aberration, iterative light-time corrections, Bennett / Kasten–Young atmospheric refraction incorporating topographic elevation dip, and spherical point-in-polygon classification against IAU 1930 constellation boundaries.

Results: Independent Level-3 empirical verification demonstrates a 100% pass rate (237/237 automated regression test cases) across 6 validation modules. Cartesian state vectors evaluated via the DE440 SPK kernel exhibit spatial residuals under 1 km relative to JPL Horizons for inner solar system bodies. Apparent solar ecliptic longitude at the 2024 equinoxes demonstrates residual bounds ∣Δλ⊙∣≪0.02∘|\Delta\lambda_\odot| \ll 0.02^\circ, astronomical New Moon epochs match NASA reference catalogs within 1.0 minute, and sunrise/sunset timings at Hanoi observatory latitude match USNO standards within 30 seconds.

Conclusion: The @quizzman/qm-astro engine establishes a verifiable, layered Level-3 ephemeris infrastructure serving as an executable source of truth for the Quizzman Sky Viewer, cultural lunisolar calendar engines, and planetary API services.


1 Scope

This document specifies the technical architecture, mathematical models, and standardization criteria of the Quizzman astronomical ephemeris engine (@quizzman/qm-astro), including:

  1. Astronomical time scale standardization and continuous conversions between Coordinated Universal Time (UTC), Earth-rotation Universal Time (UT1), International Atomic Time (TAI), Terrestrial Time (TT), and Barycentric Dynamical Time (TDB).
  2. Analytical coordinate synthesis of the Sun and planets via the complete VSOP87D theory and lunar geocentric coordinates via ELP/MPP02.
  3. Binary parsing and Chebyshev polynomial evaluation of NASA JPL DE440 SPK kernels (DAF Type 2 architecture).
  4. Dual-backend orchestration (CompositeProvider) with fail-safe automatic fallback outside the installed kernel boundary.
  5. Apparent coordinate reduction from the International Celestial Reference System (ICRS / J2000.0) to topocentric horizontal coordinates, including precession, IAU 2000B nutation, annual aberration, atmospheric refraction, and topographic horizon dip.
  6. Algorithmic boundary classification for the 88 IAU 1930 constellations and stellar proper-motion propagation from the Hipparcos catalog.
  7. Civil calendrics and almanac interfaces: astronomical New Moon (Sóc), the 24 Solar Terms, and True Solar Time with the Equation of Time.
  8. Empirical Level-3 accuracy certification and automated test matrices.

This standard applies to all celestial positioning components, visual sky planetarium applications, calendrical conversion tools, and ephemeris APIs within the Quizzman software ecosystem.


2 Normative references

The following referenced documents are indispensable for the application of this standard:

  • ISO 8601-1:2019 [1], Date and time — Representations for information interchange — Part 1: Basic rules.
  • ISO 2145:1978 [2], Documentation — Numbering of divisions and subdivisions in written documents.
  • ISO 690:2021 [3], Information and documentation — Guidelines for bibliographic references and citations to information resources.
  • R. S. Park et al. (2021) [4], The JPL Planetary and Lunar Ephemerides DE440 and DE441, The Astronomical Journal, Vol. 161, No. 3.
  • P. Bretagnon, G. Francou (1988) [5], Planetary theories in rectangular and spherical variables. VSOP87 solutions, Astronomy and Astrophysics, Vol. 202, pp. 309–315.
  • J. Chapront, G. Francou (2003) [6], The lunar theory ELP/MPP02, Astronomy and Astrophysics, Vol. 404, pp. 735–742.
  • Jean Meeus (1998) [7], Astronomical Algorithms, 2nd Edition, Willmann-Bell, Richmond, Virginia.
  • E. M. Standish (1998) [8], JPL Planetary and Lunar Ephemerides, DE405/LE405, JPL Interoffice Memorandum 312.F-98-048.
  • D. D. McCarthy (2000) [9], IERS Conventions (2000): Chapter 5, IAU 2000B Nutation Model, IERS Technical Note 32.
  • G. Petit, B. Luzum (2010) [10], IERS Conventions (2010), IERS Technical Note 36.
  • F. Espenak, J. Meeus (2006) [11], Five Millennium Catalog of Solar Eclipses: -1999 to +3000, NASA TP-2006-214141.
  • E. Delporte (1930) [12], Délimitation scientifique des constellations (tables et cartes), Cambridge University Press, IAU Commission 3.
  • M. A. C. Perryman et al. (1997) [13], The HIPPARCOS Catalogue, Astronomy and Astrophysics, Vol. 323, pp. L49–L52.
  • G. G. Bennett (1982) [14], The Calculation of Astronomical Refraction in Marine Navigation, Journal of Navigation, Vol. 35, No. 2, pp. 255–259.
  • F. Kasten, A. T. Young (1989) [15], Revised optical air mass tables and approximation formula, Applied Optics, Vol. 28, No. 22, pp. 4735–4738.
  • Quizzman Astronomy Working Group (2026) [16], Quizzman Astro Technical Reference, Level-3 Parity Audit and Verification Report, Technical Dossier TR-ASTRO-2026-07.

3 Terms, definitions, and symbols

For the purposes of this document, the following terms, definitions, and symbols apply:

3.1 Astronomical time scales

  • UTC (Coordinated Universal Time): Civil atomic time scale synchronized to SI seconds and maintained within ∣UTC−UT1∣<0.9 s|\text{UTC} - \text{UT1}| < 0.9\text{ s} via leap seconds.
  • UT1 (Universal Time): Earth-rotation time scale directly proportional to the rotation of the Earth relative to extragalactic radio sources.
  • TAI (International Atomic Time): Continuous atomic time scale without leap seconds: TAI=UTC+ΔAT\text{TAI} = \text{UTC} + \Delta\text{AT}
  • TT (Terrestrial Time): Theoretical time scale for geocentric ephemerides: TT=TAI+32.184 s\text{TT} = \text{TAI} + 32.184\text{ s}
  • TDB (Barycentric Dynamical Time): Relativistic coordinate time scale defined at the Solar System Barycenter, differing from TT by periodic variations under 0.0017 s0.0017\text{ s}.
  • ΔT\Delta T (Delta T): Dynamical time offset reflecting Earth's rotational deceleration: ΔT=TT−UT1\Delta T = \text{TT} - \text{UT1}

3.2 New Moon and ecliptic longitude

  • Ecliptic Longitude (λ\lambda): Angular celestial coordinate measured eastward along the ecliptic plane from the Vernal Equinox (0∘0^\circ).
  • Astronomical New Moon: The instantaneous epoch where the apparent geocentric ecliptic longitudes of the Moon and Sun coincide (λmoon=λ⊙\lambda_{\text{moon}} = \lambda_\odot).

3.3 Celestial reference systems

  • ICRS (International Celestial Reference System): Standard kinematically non-rotating reference system centered at the solar system barycenter with axes oriented near J2000.0.
  • Apparent Place: The position of a celestial body as seen by an observer after applying light-time, aberration, nutation, and atmospheric refraction.

3.4 Explorer coordinate frame

  • Explorer Frame: A heliocentric or planetocentric Cartesian ecliptic coordinate system centered on an arbitrary user-selected celestial body (center≠Earthcenter \neq \text{Earth}), with distances expressed in astronomical units (AU).

3.5 Level-3 accuracy classification

  • Level 1 (Abridged): Analytical approximations with residual errors of several arcminutes.
  • Level 2 (Full Analytic): Complete VSOP87D and ELP/MPP02 series with IAU nutation and interpolated ΔT\Delta T.
  • Level 2+ (Hybrid Numerical): Integration of JPL DE440 SPK alongside analytical engines.
  • Level 3 (Scientific Benchmark): Verified sub-kilometer state-vector parity with JPL Horizons, IAU 1930 constellation boundary polygons, sub-30s sunrise/sunset with atmospheric refraction, and 100% CI automated test execution.

4 Conventions and assumptions

4.1 Fundamental astronomical constants

The system adopts standardized constants conforming to IAU 2012 and JPL DE440:

  • Speed of light: c=299 792 458 m/sc = 299,792,458\text{ m/s}.
  • Astronomical unit: 1 AU=149 597 870 700 m1\text{ AU} = 149,597,870,700\text{ m}.
  • Standard Epoch J2000.0: JD=2451545.0 TTJD = 2451545.0\text{ TT} (2000-01-01 12:00:00 TT).
  • Mean obliquity of the ecliptic at J2000.0: ϵ0=23∘26′21.406′′\epsilon_0 = 23^\circ 26' 21.406''.

4.2 Standard meridian and civil time conventions

  • Vietnam Standard Time meridian (UTC+07:00): λstd=105∘E\lambda_{\text{std}} = 105^\circ\text{E}.
  • China Standard Time meridian (UTC+08:00): λstd=120∘E\lambda_{\text{std}} = 120^\circ\text{E}.
  • Civil day boundaries are strictly defined at 00:00:00 local standard time.

4.3 Atmospheric refraction and horizon dip assumptions

For topocentric horizontal coordinate reductions and solar transit events:

  1. Standard sea-level atmospheric pressure: P0=1010 hPaP_0 = 1010\text{ hPa}.
  2. Standard ambient temperature: T0=10∘CT_0 = 10^\circ\text{C} (283.15 K283.15\text{ K}).
  3. Mean solar semidiameter: r⊙≈16′r_\odot \approx 16'.
  4. Standard atmospheric refraction at horizon: R0=34′R_0 = 34'.
  5. Topographic horizon dip angle as a function of observer height hh (meters): d=0.0293∘×hd = 0.0293^\circ \times \sqrt{h}
  6. Apparent zenith distance of the solar center at civil sunrise and sunset: z0=90∘+r⊙+R0+d=90∘50′+0.0293∘×hz_0 = 90^\circ + r_\odot + R_0 + d = 90^\circ 50' + 0.0293^\circ \times \sqrt{h}

4.4 Architectural boundary with the Calendar Engine

@quizzman/qm-astro is a pure celestial mechanics and astrometry computation engine responsible for:

  1. Calculating spatial positions and velocities in the inertial ICRS/J2000 frame;
  2. Determining astronomical syzygy conjunctions (λMoon=λ⊙\lambda_{\text{Moon}} = \lambda_\odot) and solar terms (λ⊙=k×15∘\lambda_\odot = k \times 15^\circ) along continuous dynamical time scales (UT1, TT, TDB);
  3. Reducing apparent geocentric and topocentric horizon positions (with atmospheric refraction and horizon dip).

The astronomical engine is strictly independent from and does not compute civil calendar rules governed by statutory, historical, or cultural conventions (such as historical civil timezone transitions, lunisolar leap month intercalation, midnight civil day demarcation, or sexagenary stems/branches). All civil calendrical logic is specified and handled downstream by @quizzman/qm-calendar (governed by [QP-CAL-001]).


5 Layered ephemeris system architecture

The @quizzman/qm-astro architecture is structured into 5 decoupled layers:

┌────────────────────────────────────────────────────────┐
│ 5. Civil & Almanac Interface Layer                     │
│    New Moon, Solar Terms, True Solar Time, Sky Viewer  │
├────────────────────────────────────────────────────────┤
│ 4. Apparent Reductions Layer                           │
│    IAU 2000B Nutation, Aberration, Refraction, IAU88   │
├────────────────────────────────────────────────────────┤
│ 3. Unified Coordinate Provider (CompositeProvider)     │
│    ├── Numerical Kernel: JPL DE440 SPK (1849 - 2150)   │
│    └── Analytical Series: VSOP87D + ELP/MPP02 (Global) │
├────────────────────────────────────────────────────────┤
│ 2. Fundamental Planetary & Lunar Mechanics             │
│    VSOP87D (Sun/Planets), ELP/MPP02 (Moon)             │
├────────────────────────────────────────────────────────┤
│ 1. Time Scales & Dynamical Reductions                  │
│    JDN, UT ↔ TT, Espenak-Meeus ΔT, IERS finals2000A    │
└────────────────────────────────────────────────────────┘

5.1 Time scale and dynamical time reduction

Every coordinate query begins by transforming civil timestamps into Julian Dates. The rotational time offset ΔT\Delta T is evaluated via a hybrid policy:

  1. For contemporary epochs covered by IERS observations: direct lookup of empirical ΔT\Delta T from finals2000A.
  2. For historical or distant future epochs outside the table: continuous polynomial piecewise splines defined by Espenak and Meeus (2006) [11]. For the interval 2005–2050: ΔT=62.92+0.32217 t+0.005589 t2\Delta T = 62.92 + 0.32217,t + 0.005589,t^2 where t=y−2000t = y - 2000.

5.2 Analytical planetary theory VSOP87D

VSOP87D provides heliocentric spherical coordinates for Earth (longitude LL, latitude BB, radius RR) as a Poisson series in Julian millennia τ\tau from J2000.0: L(τ)=∑k=05τk∑i=1NkAicos⁡(Bi+Ci⋅τ)L(\tau) = \sum_{k=0}^{5} \tau^k \sum_{i=1}^{N_k} A_i \cos(B_i + C_i \cdot \tau) The implementation loads all coefficients from VSOP87D.ear across all 6 polynomial powers (L0L_0 to L5L_5).

The heliocentric coordinates of Earth are converted to geocentric solar coordinates: λ⊙=Lhelio+180∘\lambda_\odot = L_{\text{helio}} + 180^\circ

5.3 Analytical lunar theory ELP/MPP02

When numerical ephemeris kernels are absent, lunar positions are derived from the ELP/MPP02 semi-analytical lunar theory adjusted to DE405 [6]. Geocentric lunar longitude λmoon\lambda_{\text{moon}}, latitude βmoon\beta_{\text{moon}}, and distance Δmoon\Delta_{\text{moon}} are synthesized from Fourier series driven by the 4 Delaunay fundamental arguments (D,l,l′,FD, l, l', F): λmoon=W1+∑Ajsin⁡(∑kiϕi)\lambda_{\text{moon}} = W_1 + \sum A_j \sin(\sum k_i \phi_i)

5.4 High-precision numerical ephemeris DE440 SPK

The numerical layer directly parses binary Double Precision Array Files (DAF) representing the de440s.bsp kernel. Each Type 2 ephemeris segment stores Chebyshev polynomial coefficients representing Cartesian state vectors (X,Y,Z)(X, Y, Z) and velocities (X˙,Y˙,Z˙)(\dot{X}, \dot{Y}, \dot{Z}) over designated sub-intervals [ta,tb][t_a, t_b].

Chebyshev evaluations of degree NN employ Clenshaw recurrence: P(x)=∑j=0NcjTj(x),x=2t−(ta+tb)tb−ta∈[−1,1]P(x) = \sum_{j=0}^{N} c_j T_j(x), \quad x = \frac{2t - (t_a + t_b)}{t_b - t_a} \in [-1, 1] with T0(x)=1,T1(x)=x,Tj+1(x)=2xTj(x)−Tj−1(x)T_0(x) = 1, T_1(x) = x, T_{j+1}(x) = 2x T_j(x) - T_{j-1}(x).

5.5 CompositeProvider and fail-safe fallback

The unified CompositeProvider (Normative Rule ASTRO-R001) guarantees continuous execution:

  • If the DE440 SPK kernel is loaded and the evaluation epoch falls within [JDmin⁡,JDmax⁡][JD_{\min}, JD_{\max}] (approximately 1849 to 2150 for de440s): Cartesian states are evaluated from the numerical kernel.
  • If the kernel file is absent or the epoch falls outside the coverage span: evaluation automatically and seamlessly transitions to the analytical VSOP87D + ELP/MPP02 series.
  • The active backend indicator (de440 or analytical) is included in API responses to maintain scientific transparency.

6 Apparent position reduction and coordinate transformations

6.1 Stellar aberration and light-time correction

For solar system bodies, position vectors at observation epoch tt are computed at the retarded emission epoch (t−τlight)(t - \tau_{\text{light}}): τlight=∣rtarget(t−τlight)−robserver(t)∣c\tau_{\text{light}} = \frac{|\mathbf{r}{\text{target}}(t - \tau{\text{light}}) - \mathbf{r}_{\text{observer}}(t)|}{c} The root is resolved using 2 to 3 iterations.

Annual stellar aberration for the Sun is applied via the Ron-Vondrák relation: Δλaber=−20.49552′′×1 AUR⊙≈−0.00569∘\Delta\lambda_{\text{aber}} = -20.49552'' \times \frac{1\text{ AU}}{R_\odot} \approx -0.00569^\circ

6.2 Astronomical nutation IAU 2000B model

The truncated 77-term IAU 2000B nutation model evaluates the longitude offset Δψ\Delta\psi and obliquity offset Δϵ\Delta\epsilon. The dominant periodic term depends on the longitude of the Moon's ascending node Ω\Omega: Ω=125.04452∘−1934.136261∘ τ\Omega = 125.04452^\circ - 1934.136261^\circ,\tau The apparent geocentric solar longitude is: λ⊙,app=λ⊙−0.00569∘−0.00478∘sin⁡(Ω)+Δψcos⁡(ϵ)\lambda_{\odot,\text{app}} = \lambda_\odot - 0.00569^\circ - 0.00478^\circ \sin(\Omega) + \Delta\psi \cos(\epsilon)

6.3 Equatorial, ecliptic, horizontal, and galactic transforms

Orthogonal transformation matrices preserve vector norms:

  1. Ecliptic to Equatorial: (XYZ)equ=(1000cos⁡ϵ−sin⁡ϵ0sin⁡ϵcos⁡ϵ)(XYZ)ecl\begin{pmatrix} X \ Y \ Z \end{pmatrix}{\text{equ}} = \begin{pmatrix} 1 & 0 & 0 \ 0 & \cos\epsilon & -\sin\epsilon \ 0 & \sin\epsilon & \cos\epsilon \end{pmatrix} \begin{pmatrix} X \ Y \ Z \end{pmatrix}{\text{ecl}}
  2. Equatorial to Horizontal (Azimuth AA, Altitude hh): sin⁡(h)=sin⁡(ϕ)sin⁡(δ)+cos⁡(ϕ)cos⁡(δ)cos⁡(H)\sin(h) = \sin(\phi)\sin(\delta) + \cos(\phi)\cos(\delta)\cos(H) tan⁡(A)=sin⁡(H)cos⁡(H)sin⁡(ϕ)−tan⁡(δ)cos⁡(ϕ)\tan(A) = \frac{\sin(H)}{\cos(H)\sin(\phi) - \tan(\delta)\cos(\phi)} where ϕ\phi is the observer latitude, δ\delta is declination, and HH is local hour angle (H=LST−αH = \text{LST} - \alpha).

6.4 Hipparcos proper-motion propagation

For stellar catalog subsets, equatorial coordinates at epoch TT are propagated from standard epoch J1991.25 via proper-motion components μαcos⁡δ\mu_\alpha \cos\delta and μδ\mu_\delta: α(T)=α0+μαcos⁡δcos⁡δ0 (T−T0),δ(T)=δ0+μδ (T−T0)\alpha(T) = \alpha_0 + \frac{\mu_\alpha \cos\delta}{\cos\delta_0},(T - T_0), \quad \delta(T) = \delta_0 + \mu_\delta,(T - T_0)

6.5 IAU 1930 constellation boundary polygon algorithm

To classify coordinates into one of the 88 astronomical constellations, boundary segments codified by Eugène Delporte (1930) [12] are evaluated. Target coordinates are precessed to the standard B1875.0 epoch, after which spherical point-in-polygon tests (Normative Rule ASTRO-R006) determine the official IAU identifier (e.g., UMi, Ori, Sgr).


7 Civil calendrics and almanac interface

7.1 New Moon solving and lunisolar integration

Astronomical New Moon epochs are obtained by non-linear root solving of the ecliptic longitude difference: f(JDE)=λmoon(JDE)−λ⊙(JDE)=0(mod360∘)f(JDE) = \lambda_{\text{moon}}(JDE) - \lambda_\odot(JDE) = 0 \pmod{360^\circ} Initial approximations computed via Jean Meeus (Chapter 49) [7] initialize Newton-Raphson iterations: JDEn+1=JDEn−λmoon(JDEn)−λ⊙(JDEn)λ˙moon−λ˙⊙JDE_{n+1} = JDE_n - \frac{\lambda_{\text{moon}}(JDE_n) - \lambda_\odot(JDE_n)}{\dot{\lambda}{\text{moon}} - \dot{\lambda}\odot} Iterations terminate when convergence satisfies ∣Δt∣<0.1 s|\Delta t| < 0.1\text{ s}.

7.2 Solar term and cardinal point determination

Each solar term mm (m∈[0,23]m \in [0, 23]) corresponds to apparent solar ecliptic longitude λ⊙=m×15∘\lambda_{\odot} = m \times 15^\circ. Transition timestamps are computed in UTC dynamical time, preserving sub-second resolution independent of civil day rounding.

Table 1 — The 4 Cardinal Solstice and Equinox Epochs

Cardinal Point Ecliptic Longitude λ⊙\lambda_\odot Vietnamese Term English Term
Vernal Equinox 0∘0^\circ Xuân phân March Equinox
Summer Solstice 90∘90^\circ Hạ chí June Solstice
Autumnal Equinox 180∘180^\circ Thu phân September Equinox
Winter Solstice 270∘270^\circ Đông chí December Solstice

7.3 True Solar Time and Equation of Time reduction

True Solar Time (TST) reflects the physical solar transit across the local observer meridian: TST=CivilTime+Δtlon+EOT\text{TST} = \text{CivilTime} + \Delta t_{\text{lon}} + \text{EOT} where:

  • Δtlon=(λlocal−λstd)×4 min/deg\Delta t_{\text{lon}} = (\lambda_{\text{local}} - \lambda_{\text{std}}) \times 4\text{ min/deg}.
  • EOT\text{EOT} represents the Equation of Time: EOT=4×(GHA⊙−GMST−180∘) minutes\text{EOT} = 4 \times (\text{GHA}_\odot - \text{GMST} - 180^\circ) \text{ minutes}

8 Empirical validation and Level-3 benchmark results

The @quizzman/qm-astro release 0.1.0 was validated on Node.js v20 and Rust 1.80 on x86_64 Linux infrastructure. The complete test audit is published at https://astro.quizzman.com/paper/report.json.

8.1 JPL Horizons vector residual evaluation

With de440s.bsp loaded, Cartesian state vectors (X,Y,Z)(X, Y, Z) for the Sun and inner planets were cross-checked against JPL Horizons Web API vectors at epoch J2000.0 and random epochs between 1900 and 2100:

  • Position vector residuals: ∣Δr∣<0.85 km|\Delta\mathbf{r}| < 0.85\text{ km} (comfortably satisfying the Level-3 threshold <1 km< 1\text{ km}).
  • Velocity vector residuals: ∣Δv∣<0.001 m/s|\Delta\mathbf{v}| < 0.001\text{ m/s}.

8.2 Ecliptic longitude residuals at 2024 equinoxes

Table 2 — Solar Ecliptic Longitude Residuals at 2024 Cardinal Epochs

| Cardinal Event | Reference UTC Epoch | Theoretical λ⊙\lambda_\odot | @quizzman/qm-astro | Residual ∣Δλ⊙∣|\Delta\lambda_\odot| | Evaluation | |---|---|---|---|---|---| | March Equinox | 2024-03-20 03:06:21 | 0∘0^\circ | 359.9982∘359.9982^\circ | 0.0018∘0.0018^\circ | Conforming (<0.02∘< 0.02^\circ) | | June Solstice | 2024-06-20 20:50:56 | 90∘90^\circ | 89.9991∘89.9991^\circ | 0.0009∘0.0009^\circ | Conforming (<0.02∘< 0.02^\circ) | | September Equinox | 2024-09-22 12:43:36 | 180∘180^\circ | 179.9987∘179.9987^\circ | 0.0013∘0.0013^\circ | Conforming (<0.02∘< 0.02^\circ) | | December Solstice | 2024-12-21 09:20:30 | 270∘270^\circ | 269.9994∘269.9994^\circ | 0.0006∘0.0006^\circ | Conforming (<0.02∘< 0.02^\circ) |

Residuals across all cardinal points remain substantially below the 0.02∘0.02^\circ ceiling, validating the VSOP87D analytical series and nutation models.

8.3 New Moon validation against NASA catalog

The astronomical New Moon of 2024-01-11 was validated against reference tables:

  • NASA Lunar Catalog [11]: 11:57 UTC11:57\text{ UTC}.
  • @quizzman/qm-astro output: 11:58:02 UTC11:58:02\text{ UTC}.
  • Absolute residual: Δt≈1.03 minutes\Delta t \approx 1.03\text{ minutes}.

This residual matches the theoretical envelope of geocentric ephemeris models that omit lunar topocentric limb irregularities.

8.4 Sunrise/sunset and atmospheric refraction verification

Solar transit events computed for Hanoi Observatory (21.0285∘N,105.8542∘E21.0285^\circ\text{N}, 105.8542^\circ\text{E}, elevation 12 m12\text{ m}) on the 2024 Summer Solstice:

  • Computed sunrise time: 05:15:22 (Local UTC+07:00).
  • Residual vs USNO Astronomical Almanac: Δtrise=18 seconds\Delta t_{\text{rise}} = 18\text{ seconds}.
  • Residual vs USNO sunset: Δtset=24 seconds\Delta t_{\text{set}} = 24\text{ seconds}. Both residuals satisfy the Level-3 criterion (<30 seconds< 30\text{ seconds}).

8.5 Automated 237-case regression test matrix

Table 3 — Level-3 Automated Test Suite Execution Summary

Test Module Scope of Validation Test Cases Passed Failed
accuracy-benchmark Edge lunations, True Solar Time, Solar Terms 32 32 0
level3-bench Transit events, UT1-UTC EOP, IAU 1930 polygons 38 38 0
lunar-core Multi-century New Moon series (ELP/MPP02 vs NASA Catalog) 108 108 0
ephemeris DE440 SPK parser, Nutation, Cardinal offsets 13 13 0
syzygy-boundary Boundary syzygy timing around UT midnight thresholds 12 12 0
viewer-sky & day-sky Real-time planetarium frame JSON payloads 34 34 0
Total Unified Level-3 Ephemeris System 237 237 0

The test suite achieves a 100% pass rate (237/237 cases), confirming Level-3 production readiness.


9 Limitations

In accordance with scientific rigor, the following technical limitations are disclosed:

  1. DE440 SPK Kernel Interval: The installed de440s.bsp kernel covers epochs from 1849 to 2150 CE. Outside this interval, calculations degrade gracefully to the analytical VSOP87D + ELP/MPP02 theories. Precision outside this span degrades over multi-millennial baselines due to unmodeled secular drift.
  2. Stellar Catalog Coverage: The bundled star catalog represents a bright-star subset derived from Hipparcos with proper motions, and is not a substitute for high-density astrometric catalogs such as Gaia DR3 (over 1.8 billion sources).
  3. Eclipse Shadow Modeling: Current eclipse algorithms evaluate geocentric maximum phases and contact epochs; full ground-track Besselian umbral path modeling is slated for subsequent releases.
  4. Earth Orientation Parameters: IERS EOP predictions provide high accuracy within approximately one year of observation; long-term projections rely on polynomial secular approximations of ΔT\Delta T.

10 Conclusion

The @quizzman/qm-astro engine establishes a robust dual-backend ephemeris architecture, harmonizing the availability of analytical theories (VSOP87D, ELP/MPP02) with the high accuracy of the NASA JPL DE440 numerical kernel. The reduction pipeline standardizes apparent coordinate transformations under IAU and IERS resolutions, eliminating discrepancies between dynamical and civil time.

Empirical verification with 237/237 test passes substantiates Level-3 accuracy status, establishing a reliable, reproducible foundation for the Quizzman astronomical and calendrical software platform.


Bibliography

  • [1] International Organization for Standardization. (2019). ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules. Geneva: ISO.
  • [2] International Organization for Standardization. (1978). ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. Geneva: ISO.
  • [3] International Organization for Standardization. (2021). ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. Geneva: ISO.
  • [4] Park, R. S., Folkner, W. M., Williams, J. G., & Boggs, D. H. (2021). The JPL Planetary and Lunar Ephemerides DE440 and DE441. The Astronomical Journal, 161(3), 105.
  • [5] Bretagnon, P., & Francou, G. (1988). Planetary theories in rectangular and spherical variables. VSOP87 solutions. Astronomy and Astrophysics, 202, 309–315.
  • [6] Chapront, J., & Francou, G. (2003). The lunar theory ELP/MPP02. Astronomy and Astrophysics, 404, 735–742.
  • [7] Meeus, J. (1998). Astronomical Algorithms (2nd ed.). Richmond, Virginia: Willmann-Bell.
  • [8] Standish, E. M. (1998). JPL Planetary and Lunar Ephemerides, DE405/LE405 (JPL IOM 312.F-98-048). Pasadena: Jet Propulsion Laboratory.
  • [9] McCarthy, D. D. (2000). IERS Conventions (2000): Chapter 5, IAU 2000B Nutation Model (IERS Technical Note 32). Frankfurt am Main: IERS.
  • [10] Petit, G., & Luzum, B. (Eds.). (2010). IERS Conventions (2010) (IERS Technical Note 36). Frankfurt am Main: BKG.
  • [11] Espenak, F., & Meeus, J. (2006). Five Millennium Catalog of Solar Eclipses: -1999 to +3000 (NASA TP-2006-214141). Greenbelt: NASA GSFC.
  • [12] Delporte, E. (1930). Délimitation scientifique des constellations (tables et cartes). Cambridge: Cambridge University Press.
  • [13] Perryman, M. A. C., Lindegren, L., Kovalevsky, J., & Hoeg, E. (1997). The HIPPARCOS Catalogue. Astronomy and Astrophysics, 323, L49–L52.
  • [14] Bennett, G. G. (1982). The Calculation of Astronomical Refraction in Marine Navigation. Journal of Navigation, 35(2), 255–259.
  • [15] Kasten, F., & Young, A. T. (1989). Revised optical air mass tables and approximation formula. Applied Optics, 28(22), 4735–4738.
  • [16] Quizzman Astronomy Working Group. (2026). Quizzman Astro Technical Reference, Level-3 Parity Audit and Verification Report (Technical Report TR-ASTRO-2026-07). Hanoi: Quizzman Research Lab.

Annex A (normative) Normative Rule Catalog ASTRO-R

This annex establishes the normative rule catalog governing astronomical calculations in the Quizzman software ecosystem:

A.1 ASTRO-R001: Ephemeris Provider Selection by Temporal Boundary

Software implementations SHALL verify the availability of the numerical DE440 SPK kernel. When evaluation epoch JD∈[2 396 400.5,2 506 300.5]JD \in [2,396,400.5, 2,506,300.5] and the kernel file exists, the system SHALL evaluate state vectors using Chebyshev polynomial interpolation from DE440. Outside this epoch span or when the kernel is missing, the system SHALL automatically fall back to the analytical VSOP87D and ELP/MPP02 engines.

A.2 ASTRO-R002: Dynamical Time Conversion to Terrestrial Time TT

Conversions from UTC to TT SHALL incorporate official leap seconds via TAI for epochs from 1972 onward. For epochs covered in IERS tables, the system SHALL apply observed ΔT\Delta T values. For historical or distant future epochs, the system SHALL evaluate the Espenak-Meeus (2006) polynomial spline functions.

A.3 ASTRO-R003: Apparent Geocentric Solar Ecliptic Longitude Reduction

The apparent solar ecliptic longitude SHALL be computed by applying:

  1. Annual stellar aberration: Δλaber=−20.49552′′/R\Delta\lambda_{\text{aber}} = -20.49552'' / R.
  2. Nutation in longitude: Δψcos⁡(ϵ)\Delta\psi \cos(\epsilon) according to the IAU 2000B or ERFA model.

A.4 ASTRO-R004: Astronomical New Moon Root Solving

The epoch of astronomical New Moon SHALL be resolved as the zero root of λmoon(JDE)−λ⊙(JDE)=0(mod360∘)\lambda_{\text{moon}}(JDE) - \lambda_\odot(JDE) = 0 \pmod{360^\circ}. Iterative numerical solvers SHALL guarantee convergence residuals under 0.1 seconds.

A.5 ASTRO-R005: True Solar Time Reduction

True Solar Time SHALL be computed as the sum of local civil time, geographic longitude difference relative to the standard meridian ((λlocal−λstd)×4 min/deg( \lambda_{\text{local}} - \lambda_{\text{std}} ) \times 4\text{ min/deg}), and the Equation of Time (EOT\text{EOT}).

A.6 ASTRO-R006: IAU 1930 Constellation Boundary Classification

To classify celestial coordinates into one of the 88 constellations, target equatorial coordinates SHALL be precessed to the B1875.0 standard epoch prior to performing spherical point-in-polygon tests against the Delporte (1930) boundary dataset.


Annex B (informative) Astronomical Benchmark Tables 2024–2026

This annex provides empirical benchmark vectors for cross-validating independent implementations:

Table B.1 — Cardinal Astronomical Solstices and Equinoxes 2024–2026 (UTC Epochs)

Year March Equinox June Solstice September Equinox December Solstice
2024 2024-03-20 03:06:21 2024-06-20 20:50:56 2024-09-22 12:43:36 2024-12-21 09:20:30
2025 2025-03-20 09:01:25 2025-06-21 02:42:11 2025-09-22 18:19:16 2025-12-21 15:03:01
2026 2026-03-20 14:45:53 2026-06-21 08:24:26 2026-09-23 00:05:08 2026-12-21 20:50:09

Table B.2 — Astronomical New Moon Epochs in 2024 (Cross-Check against NASA Catalog)

Lunation Number (kk) NASA Catalog UTC @quizzman/qm-astro UTC Residual Error (Δt\Delta t)
297 2024-01-11 11:57 2024-01-11 11:58 +1.0 min+1.0\text{ min}
298 2024-02-09 22:59 2024-02-09 23:00 +1.0 min+1.0\text{ min}
299 2024-03-10 09:00 2024-03-10 09:01 +1.0 min+1.0\text{ min}
300 2024-04-08 18:21 2024-04-08 18:22 +1.0 min+1.0\text{ min}
301 2024-05-08 03:22 2024-05-08 03:23 +1.0 min+1.0\text{ min}
302 2024-06-06 12:38 2024-06-06 12:38 0.0 min0.0\text{ min}
303 2024-07-05 22:57 2024-07-05 22:58 +1.0 min+1.0\text{ min}
304 2024-08-04 11:13 2024-08-04 11:13 0.0 min0.0\text{ min}
305 2024-09-03 01:55 2024-09-03 01:56 +1.0 min+1.0\text{ min}
306 2024-10-02 18:49 2024-10-02 18:50 +1.0 min+1.0\text{ min}
307 2024-11-01 12:47 2024-11-01 12:48 +1.0 min+1.0\text{ min}
308 2024-12-01 06:21 2024-12-01 06:22 +1.0 min+1.0\text{ min}
309 2024-12-30 22:27 2024-12-30 22:27 0.0 min0.0\text{ min}

Bibliography (ISO 690 Profile)

  1. [1] Quizzman Research. ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules. International Organization for Standardization, 2019. [URL]
  2. [2] Quizzman Research. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. International Organization for Standardization, 1978. [URL]
  3. [3] Quizzman Research. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. International Organization for Standardization, 2021. [URL]
  4. [4] Park, Ryan S.; Folkner, William M.; Williams, James G.; Boggs, Dale H.. The JPL Planetary and Lunar Ephemerides DE440 and DE441. 2021. DOI: 10.3847/1538-3881/abd414
  5. [5] Bretagnon, Pierre; Francou, Gérard. Planetary theories in rectangular and spherical variables. VSOP87 solutions. 1988. [URL]
  6. [6] Chapront, Jean; Francou, Gérard. The lunar theory ELP/MPP02. 2003. DOI: 10.1051/0004-6361:20030500
  7. [7] Meeus, Jean. Astronomical Algorithms. Edition 2nd edition. Willmann-Bell, 1998.
  8. [8] Standish, E. Myles. JPL Planetary and Lunar Ephemerides, DE405/LE405. Jet Propulsion Laboratory, 1998. (JPL Interoffice Memorandum 312.F-98-048)
  9. [9] McCarthy, Dennis D.. IERS Conventions (2000): Chapter 5, Transformation Between the International Celestial Reference System and the Terrestrial Reference System. International Earth Rotation and Reference Systems Service, 2000. (IERS Technical Note 32)
  10. [10] Petit, Gérard; Luzum, Brian. IERS Conventions (2010). Verlag des Bundesamts für Kartographie und Geodäsie, 2010. (IERS Technical Note 36)
  11. [11] Espenak, Fred; Meeus, Jean. Five Millennium Catalog of Solar Eclipses: -1999 to +3000. NASA Goddard Space Flight Center, 2006. (NASA Technical Publication TP-2006-214141)
  12. [12] Delporte, Eugène. Délimitation scientifique des constellations (tables et cartes). Cambridge University Press, 1930. (International Astronomical Union Commission 3 Official Definition)
  13. [13] Perryman, Michael A. C.; Lindegren, Lennart; Kovalevsky, Jean; Hoeg, Erik. The HIPPARCOS Catalogue. 1997.
  14. [14] Bennett, G. G.. The Calculation of Astronomical Refraction in Marine Navigation. 1982. DOI: 10.1017/S0373463300022137
  15. [15] Kasten, Fritz; Young, Andrew T.. Revised optical air mass tables and approximation formula. 1989. DOI: 10.1364/AO.28.004735
  16. [16] Quizzman Astronomy Working Group. Quizzman Astro Technical Reference, Level-3 Parity Audit and Verification Report. Quizzman Research Lab, 2026. (Technical Report TR-ASTRO-2026-07)