Nauwkeurigheid is iets waar de gebruiker je stilzwijgend op controleert bij Astrodienst. Als een geboortehoroscoop een boogminuut afwijkt, komt er snel een klacht binnen. En het ergste is dat nauwkeurigheid gemakkelijk onopgemerkt kan worden verbroken: één refactoring in de efemeridecode, en de helft van de endpoints is stilletjes enkele boogseconden verschoven.
Zo voorkomen we dat dit gebeurt.
Eén kern voor twee omgevingen
Section titled “Eén kern voor twee omgevingen”Planetaire posities worden berekend op onze eigen servers, zonder externe API, met een nauwkeurigheid tot op de boogseconde, geverifieerd met NASA JPL Horizons. De sleutel: onze applicatie en de API hebben één rekenkern, één codebase. Er zijn geen twee implementaties die kunnen afwijken, dus er is niets dat kan afwijken.
Voor datums buiten het hoofdbereik 1800-2399 is er een analytische efemeride, iets grover (ongeveer 0.1″), maar zonder onderbrekingen aan de grenzen.
Bevroren snapshots
Section titled “Bevroren snapshots”Elk rekenkundig endpoint heeft een set bevroren snapshots - 888 JSON-fixtures op het moment van deze build. De runner voert het endpoint uit op referentiekaarten en vergelijkt byte voor byte (binnen de tolerantie) met de fixture. Elke afwijking van de planetaire lengte groter dan 5e-5° (0.18″) laat de test falen.
De referentiekaarten zijn zo gekozen dat ze de randgevallen raken, en niet alleen het “gemakkelijke” centrum:
- Monroe, Diana, Einstein, Bowie - historische kaarten met bekende geboortegegevens
- polaire breedtegraad - waar huizensystemen degenereren
- equatoriale - waar ze zich anders gedragen
- zuidelijk halfrond - controle van spiegeling
De randgevallen vangen precies die regressies op die niet zichtbaar zijn op de kaart van een doorsnee inwoner van Kiev.
Triangulatie tegen externe bronnen
Section titled “Triangulatie tegen externe bronnen”Snapshots vangen regressies op ten opzichte van zichzelf. Om de absolute waarheid te controleren, wordt elke release geverifieerd met onafhankelijke bronnen:
| Tegen wat | Wat wordt gecontroleerd | Afwijking |
|---|---|---|
| NASA JPL Horizons | planetaire posities | 231 van 231 binnen tolerantie, mediaan 0.052″ |
| swetest CGI (Astrodienst) | planetaire lengtes, huizenpunten | 0.000″ |
| Kerykeion (Python, pyswisseph) | onafhankelijke open-source bibliotheek | < 0.2″ |
| Prokerala (sidereal Lahiri) | siderische posities | 8-17″, systematisch verschil in ayanamsa-formule, geen engine |
| NASA 5-Millennium Eclipse Catalog | tijd en type verduisteringen | < 1 min |
De afwijking met Prokerala is geen fout: het zijn verschillende implementaties van de Lahiri-formule, en we documenteren dit expliciet, in plaats van het te verbergen. Met swetest, de referentie-output van Astrodienst, is de drift op deze kaarten nul.
Astrocartografische lijnen worden afzonderlijk geometrisch gecontroleerd - de nauwkeurigheid op de evenaar is beter dan 1.5 km.
Wat wordt uitgevoerd bij elke PR
Section titled “Wat wordt uitgevoerd bij elke PR”Nauwkeurigheid is een CI-gate, geen eenmalige controle:
api-accuracy.yml- voert bij elke PR in de backend-code de volledige set snapshots + triangulatie uit. Een rode test blokkeert de merge.check-eclipse-accuracy.yml- vergelijkt eens per jaar verduisteringen met de NASA-catalogus; een afwijking boven de drempel creëert automatisch een issue.
Wat dit de integrator oplevert
Section titled “Wat dit de integrator oplevert”De garantie is eenvoudig: planetaire posities zijn geverifieerd met NASA JPL Horizons, en wijken af van de referentie-output van swetest met een mediaan van 0.0013 boogseconden (maximum 0.561″, Chiron), en deze grens wordt beschermd door automatisering, niet door een belofte in de README. Als er ooit een regressie optreedt, zal deze in onze CI vallen, en niet in de klacht van je gebruiker.
De publieke versie van deze cijfers, met een tabel van afwijkingen voor specifieke kaarten, is te vinden op de pagina Nauwkeurigheid.
Posities tot op de boogseconde in 4 regels code.
Gratis sleutel zonder kaart. 5.000 calls per maand tot de eerste betaling.