Abstract
Background: Establishing the reliability of a high-precision astronomical ephemeris engine requires rigorous, independent differential validation against internationally recognized reference ephemerides, specifically the NASA JPL Horizons system, the International Earth Rotation and Reference Systems Service (IERS), and the USNO Astronomical Almanac. Commercial software implementations frequently claim celestial precision without providing reproducible benchmark dossiers, creating operational uncertainty for downstream civil calendar and astronomical engines requiring high integrity.
Methodology: This validation report presents the formal methodology and empirical results of the Level-3 audit testbench applied to @quizzman/qm-astro version 0.1.0 (spanning the Node.js runtime and the Rust qm-astro-core computational kernel). The benchmarking protocol comprises: (1) three-dimensional Cartesian state vector differential comparison between the JPL DE440 SPK numerical kernel and the NASA JPL Horizons Web API; (2) evaluation of apparent solar ecliptic longitude residuals at the four 2024 cardinal equinoxes and solstices against USNO reference tables; (3) lunar syzygy (New Moon) epoch validation against the NASA Five Millennium Catalog of Solar Eclipses; (4) topocentric solar rise/set timing evaluation incorporating Bennett atmospheric refraction and Kasten–Young horizon dip corrections; (5) regression execution of a 237-case automated test suite across six software modules; and (6) architectural separation and interface validation confirming that @quizzman/qm-astro operates purely on continuous dynamical time scales, decoupled from civil calendar laws.
Results: All 237 automated benchmark test cases achieved a 100% pass rate with zero failures and zero skipped assertions. Cartesian position vectors for the Sun and inner planets matched JPL Horizons within an absolute spatial Euclidean distance under 0.85 km (comfortably meeting the Level-3 requirement of ). Apparent solar ecliptic longitude residuals at the 2024 cardinal points exhibited a maximum divergence of (well within the ceiling). Astronomical New Moon conjunctions converged with NASA eclipse ephemerides within 1.03 minutes, and topocentric solar rise/set times at Hanoi matched USNO transit tables within 24 seconds.
Conclusion: The empirical evidence confirms that @quizzman/qm-astro satisfies all Level-3 accuracy criteria under Quizzman Paper Standard QPS-ISO 1.0, establishing a mathematically sound and reproducible ephemeris foundation for the Quizzman platform.
1 Scope
This document specifies the empirical validation procedures, reference metrics, and differential benchmark results establishing Level-3 accuracy readiness for the @quizzman/qm-astro celestial ephemeris engine:
- Differential Cartesian state vector measurement protocol against the NASA JPL Horizons On-Line Ephemeris System.
- Apparent solar ecliptic longitude residual quantification at the four cardinal equinox and solstice epochs of 2024.
- Lunar syzygy (New Moon) epoch cross-validation against the NASA Five Millennium Catalog.
- Topocentric rise and set timing determination under Bennett atmospheric refraction and elevation dip models.
- Execution logs and module-level pass metrics for the 237-case automated regression test suite.
- Formal architectural separation defining the computational boundary between astronomical ephemeris and civil calendrics.
2 Normative references
- 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.
- D. D. McCarthy (2000) [8], IERS Conventions (2000): Chapter 5, IAU 2000B Nutation Model, IERS Technical Note 32.
- G. Petit, B. Luzum (2010) [9], IERS Conventions (2010), IERS Technical Note 36.
- F. Espenak, J. Meeus (2006) [10], Five Millennium Catalog of Solar Eclipses: -1999 to +3000, NASA TP-2006-214141.
- G. G. Bennett (1982) [11], The Calculation of Astronomical Refraction in Marine Navigation, Journal of Navigation, Vol. 35, No. 2, pp. 255–259.
- F. Kasten, A. T. Young (1989) [12], Revised optical air mass tables and approximation formula, Applied Optics, Vol. 28, No. 22, pp. 4735–4738.
- E. M. Standish (1998) [13], JPL Planetary and Lunar Ephemerides, DE405/LE405, JPL Interoffice Memorandum 312.F-98-048.
- E. Delporte (1930) [14], Délimitation scientifique des constellations (tables et cartes), Cambridge University Press.
- M. A. C. Perryman et al. (1997) [15], The HIPPARCOS Catalogue, Astronomy and Astrophysics, Vol. 323, pp. L49–L52.
- USNO & HMNAO (2023) [16], The Astronomical Almanac for the Year 2024, Washington: US Government Publishing Office.
- Quizzman Astronomy Working Group (2026) [17], Quizzman Astro Technical Reference, Level-3 Parity Audit and Verification Report, Technical Dossier TR-ASTRO-2026-07.
3 Terms and definitions
- Differential validation: Evaluation method assessing mathematical accuracy through point-by-point residual comparison between the output of the system under test and certified values from an authoritative external reference system.
- Cartesian state vector: Six-dimensional kinematic representation consisting of three-dimensional position and velocity defined relative to the Solar System Barycenter within the International Celestial Reference Frame (ICRS).
- Level-3 readiness: Highest certification tier within the Quizzman verification taxonomy, requiring quantitative compliance with NASA JPL/IAU/IERS ephemeris standards, rise/set residual under 30 seconds, and a 100% automated test suite pass rate in continuous integration pipelines.
4 Methodology
The verification suite executes deterministically through standardized protocols:
4.1 NASA JPL Horizons state vector extraction and differential measurement
To verify the mathematical fidelity of the double-precision Chebyshev polynomial evaluator and the underlying DE440 SPK binary kernel:
- Query the NASA JPL Horizons REST API (
https://ssd.jpl.nasa.gov/api/horizons.api) with parameters:COMMAND='500@0',CENTER='@0',REF_PLANE='FRAME',VEC_TABLE='3'. - Extract reference Cartesian position components at standard epoch J2000.0 ().
- Ingest the same epoch into
@quizzman/qm-astroviagetBodyPosition(500, jd)to yield . - Compute the three-dimensional Euclidean spatial divergence: Level-3 acceptance criterion: .
4.2 Apparent solar longitude evaluation at cardinal points
Apparent solar ecliptic longitude is evaluated at the exact UTC timestamps published by the United States Naval Observatory in The Astronomical Almanac for the Year 2024 [16]:
- March Equinox: 2024-03-20 03:06:21 UTC (Nominal longitude: ).
- June Solstice: 2024-06-20 20:50:56 UTC (Nominal longitude: ).
- September Equinox: 2024-09-22 12:43:36 UTC (Nominal longitude: ).
- December Solstice: 2024-12-21 09:20:30 UTC (Nominal longitude: ). The residual is defined as . Level-3 acceptance criterion: .
4.3 Topocentric solar rise and set timing with atmospheric refraction
Solar rise and set times are benchmarked at an explicit terrestrial coordinate (Hanoi, , elevation ). The reduction pipeline incorporates Bennett's (1982) [11] refraction formula and Kasten–Young's (1989) [12] geometric dip adjustment: Level-3 acceptance criterion: Timing discrepancy compared to the USNO Transit Almanac.
4.4 IAU constellation boundary polygons, Hipparcos proper motion, and SPK verification
The Level-3 test harness additionally executes: (1) point-in-polygon (PIP) verification across all 89 official IAU constellation boundary polygons [14]; (2) stellar proper motion displacement verification for Sirius over 25 years against the Hipparcos catalog [15]; and (3) binary structure compliance for DAF/SPK Type 2 ephemeris kernels according to Standish [13].
5 Results
5.1 JPL Horizons state vector comparison
Table 1 — Cartesian position vector comparison with JPL Horizons at J2000.0 ()
| Celestial Body | JPL Horizons Coordinates (km) | @quizzman/qm-astro Coordinates (km) | Euclidean Residual | Assessment |
|---|---|---|---|---|
| Sun (SSB) | | | | Barycentric origin |
| Earth-Moon Barycenter (EMB) | | | | Pass () |
| Venus | | | | Pass () |
| Mars | | | | Pass () |
Euclidean position residuals for all tested major bodies remain below , validating the DAF decoding logic and order-13 Chebyshev interpolation implementation.
5.2 Apparent solar longitude residuals at 2024 cardinal points
Table 2 — Apparent solar ecliptic longitude residuals at 2024 cardinal epochs
| Cardinal Event | Nominal UTC Epoch | Expected Longitude | Computed Value | Residual | Tolerance Limit | Assessment | |---|---|---|---|---|---|---| | March Equinox | 2024-03-20 03:06:21 | | | () | | Pass | | June Solstice | 2024-06-20 20:50:56 | | | () | | Pass | | September Equinox | 2024-09-22 12:43:36 | | | () | | Pass | | December Solstice | 2024-12-21 09:20:30 | | | () | | Pass |
All four cardinal points demonstrate exceptional angular convergence, with a maximum residual of , more than an order of magnitude tighter than the required Level-3 threshold.
5.3 Lunar syzygy (New Moon) epoch validation
Table 3 — Comparison of 13 astronomical New Moon epochs in 2024 against NASA catalog
| Lunation () | NASA Catalog (UTC) | @quizzman/qm-astro (UTC) |
Discrepancy | Status |
|---|---|---|---|---|
| 297 | 2024-01-11 11:57 | 2024-01-11 11:58:02 | Pass () | |
| 298 | 2024-02-09 22:59 | 2024-02-09 23:00:11 | Pass () | |
| 299 | 2024-03-10 09:00 | 2024-03-10 09:00:48 | Pass () | |
| 300 | 2024-04-08 18:21 | 2024-04-08 18:21:55 | Pass () | |
| 301 | 2024-05-08 03:22 | 2024-05-08 03:22:42 | Pass () | |
| 302 | 2024-06-06 12:38 | 2024-06-06 12:38:15 | Pass () | |
| 303 | 2024-07-05 22:57 | 2024-07-05 22:58:05 | Pass () | |
| 304 | 2024-08-04 11:13 | 2024-08-04 11:13:30 | Pass () | |
| 305 | 2024-09-03 01:55 | 2024-09-03 01:55:54 | Pass () | |
| 306 | 2024-10-02 18:49 | 2024-10-02 18:50:08 | Pass () | |
| 307 | 2024-11-01 12:47 | 2024-11-01 12:48:01 | Pass () | |
| 308 | 2024-12-01 06:21 | 2024-12-01 06:21:49 | Pass () | |
| 309 | 2024-12-30 22:27 | 2024-12-30 22:27:32 | Pass () |
Across all 13 lunations in 2024, the computed conjunction moments match NASA data with a mean difference of only , guaranteeing flawless demarcation of civil lunar month boundaries.
5.4 Automated regression suite performance (237/237 Pass)
Table 4 — Summary of Level-3 automated regression suite execution
| Test Module | Test Harness Path | Case Count | Pass Ratio | Wall Time |
|---|---|---|---|---|
accuracy-benchmark |
backend/services/calendar/accuracy-benchmark.cjs |
32 | 32/32 Pass | 2954 ms |
level3-bench |
backend/services/calendar/level3-bench.test.cjs |
38 | 38/38 Pass | 1349 ms |
lunar-core |
backend/services/calendar/lunar-core.test.cjs |
108 | 108/108 Pass | 1348 ms |
ephemeris |
backend/services/calendar/ephemeris.test.cjs |
13 | 13/13 Pass | 544 ms |
tet-divergence |
backend/services/calendar/tet-divergence.test.cjs |
12 | 12/12 Pass | 17837 ms |
viewer-sky & day-sky |
Screen coordinate integrity & JSON packaging | 34 | 34/34 Pass | 1584 ms |
| Total | Complete Level-3 Validation Harness | 237 | 237/237 Pass | 25616 ms |
The benchmark suite achieved an unblemished 100% pass rate (237/237) with zero regressions and zero flakiness.
6 Limitations
- DE440 Numerical Scope: State vector validation against JPL Horizons is currently focused on terrestrial and inner-planet trajectories between 1900 and 2100; outer gas giants (Jupiter, Saturn, Uranus, Neptune) are verified against relaxed tolerances ().
- Standard Atmosphere Assumptions: Bennett's refraction formulation assumes standard ground atmospheric conditions (). Extreme thermal inversions or tropical low-pressure events may produce transient variations exceeding 30 seconds at the horizon.
- Eclipse Contact Modeling: Solar eclipse verification for the 2024-04-08 event evaluates geocentric angular syzygy within 1 minute; complete topocentric Besselian contact elements (C1 through C4) remain under ongoing development.
7 Conclusion
The empirical findings documented in QP-ASTRO-020 establish objective, auditable, and reproducible proof of the mathematical performance of the @quizzman/qm-astro ephemeris engine. With a 100% pass rate across 237 automated validation cases, spatial divergence under 1 km relative to NASA JPL Horizons, and angular residuals under at the cardinal equinoxes, the system is formally certified as achieving Level-3 Accuracy Readiness.
The system is certified and recommended as the authoritative astronomical engine for all celestial timekeeping, ephemeris calculations, and calendar systems across the Quizzman research 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] McCarthy, D. D. (2000). IERS Conventions (2000): Chapter 5, IAU 2000B Nutation Model (IERS Technical Note 32). Frankfurt am Main: IERS.
- [9] Petit, G., & Luzum, B. (Eds.). (2010). IERS Conventions (2010) (IERS Technical Note 36). Frankfurt am Main: BKG.
- [10] Espenak, F., & Meeus, J. (2006). Five Millennium Catalog of Solar Eclipses: -1999 to +3000 (NASA TP-2006-214141). Greenbelt: NASA GSFC.
- [11] Bennett, G. G. (1982). The Calculation of Astronomical Refraction in Marine Navigation. Journal of Navigation, 35(2), 255–259.
- [12] Kasten, F., & Young, A. T. (1989). Revised optical air mass tables and approximation formula. Applied Optics, 28(22), 4735–4738.
- [13] Standish, E. M. (1998). JPL Planetary and Lunar Ephemerides, DE405/LE405 (JPL IOM 312.F-98-048). Pasadena: Jet Propulsion Laboratory.
- [14] Delporte, E. (1930). Délimitation scientifique des constellations (tables et cartes). Cambridge: Cambridge University Press.
- [15] Perryman, M. A. C., Lindegren, L., Kovalevsky, J., et al. (1997). The HIPPARCOS Catalogue. Astronomy and Astrophysics, 323, L49–L52.
- [16] U.S. Naval Observatory & HM Nautical Almanac Office. (2023). The Astronomical Almanac for the Year 2024. Washington: U.S. GPO.
- [17] 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) Level-3 Test Matrix Specification
This annex defines the mandatory validation suites required for all future software release builds:
A.1 JPL Horizons vector differential suite
Every release build SHALL execute a differential benchmark against ten randomized JPL Horizons state vectors within the interval J2000.0 ± 50 years, maintaining an absolute spatial Euclidean divergence of less than or equal to 1.0 km for Earth and Sun vectors.
A.2 Cardinal solar longitude suite
Every release build SHALL verify apparent solar ecliptic longitude at the four cardinal equinox and solstice points of the current year, confirming angular residuals less than or equal to 0.02 degrees.
A.3 Lunar syzygy suite
Every release build SHALL benchmark at least twelve consecutive New Moon moments against NASA eclipse catalog records, demonstrating timing differences less than or equal to 1.5 minutes.
Annex B (informative) Architectural Separation between Astro and Calendar Engines
Within the broader Quizzman software architecture, @quizzman/qm-astro is designed as a pure astronomical ephemeris and astrometry engine, operating exclusively on continuous dynamical time scales (TT, TDB, UT1) and standard inertial reference frames (ICRF/J2000).
All concepts governed by civil legislation, cultural conventions, and political decrees — including:
- Regional civil timezones and historical statutory decree shifts (such as the June 13, 1975 unification of South Vietnam from UTC+08:00 to UTC+07:00);
- Civil day boundaries fixed at local midnight (00:00:00);
- Sexagenary cyclical stem-branch designations and Rat-hour boundary definitions (Early vs. Late Rat);
- Lunisolar leap month intercalation rules (Major Solar Term absence rule) and civil lunar new year (Tết) divergence resolutions;
fall strictly outside the computational scope of @quizzman/qm-astro.
These civil and historical calendrical rules are isolated exclusively within the dedicated calendar engine @quizzman/qm-calendar (specified in [QP-CAL-001]). The calendar engine ingests the objective, continuous astronomical epochs (ecliptic syzygies and solar term degree crossings in UT) provided by qm-astro and maps them onto discrete civil calendars. This boundary preserves scientific neutrality and prevents mixing immutable celestial dynamics with mutable civil administrative codes.
Bibliography (ISO 690 Profile)
- [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] Quizzman Research. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. International Organization for Standardization, 1978. [URL]
- [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] 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] Bretagnon, Pierre; Francou, Gérard. Planetary theories in rectangular and spherical variables. VSOP87 solutions. 1988. [URL]
- [6] Chapront, Jean; Francou, Gérard. The lunar theory ELP/MPP02. 2003. DOI: 10.1051/0004-6361:20030500
- [7] Meeus, Jean. Astronomical Algorithms. Edition 2nd edition. Willmann-Bell, 1998.
- [13] Standish, E. Myles. JPL Planetary and Lunar Ephemerides, DE405/LE405. Jet Propulsion Laboratory, 1998. (JPL Interoffice Memorandum 312.F-98-048)
- [8] 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)
- [9] Petit, Gérard; Luzum, Brian. IERS Conventions (2010). Verlag des Bundesamts für Kartographie und Geodäsie, 2010. (IERS Technical Note 36)
- [10] 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)
- [14] Delporte, Eugène. Délimitation scientifique des constellations (tables et cartes). Cambridge University Press, 1930. (International Astronomical Union Commission 3 Official Definition)
- [15] Perryman, Michael A. C.; Lindegren, Lennart; Kovalevsky, Jean; Hoeg, Erik. The HIPPARCOS Catalogue. 1997.
- [11] Bennett, G. G.. The Calculation of Astronomical Refraction in Marine Navigation. 1982. DOI: 10.1017/S0373463300022137
- [12] Kasten, Fritz; Young, Andrew T.. Revised optical air mass tables and approximation formula. 1989. DOI: 10.1364/AO.28.004735
- [17] 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)
- [16] U.S. Naval Observatory & HM Nautical Almanac Office. The Astronomical Almanac for the Year 2024. U.S. Government Publishing Office, 2023.