Ακρίβεια υπολογισμών

TL;DR

AstroWay API χρησιμοποιεί Swiss Ephemeris (επίσημος C-κώδικας από Astrodienst, δημιουργούς astro.com) — τον ίδιο κινητήρα, με τον οποίο οι επαγγελματίες αστρολόγοι εργάζονται για 30+ χρόνια στο Solar Fire ($495), Kepler ($995), Astro Gold ($29.99/μήνα) και Janus. Εμείς συναρμολογούμε τον κινητήρα σε WebAssembly και παρουσιάζουμε ένα REST API-στρώμα, χωρίς μεσάζοντες. Κάθε βασικό σημείο υπολογισμού καλύπτεται από regression snapshot-тест, και η ακρίβεια του κινητήρα επαληθεύεται μέσω τριγωνομετρίας με τρία ανεξάρτητα μέσα + έναν NASA 5-Millennium Eclipse Catalog:

Πλανητικές θέσεις: < 0.1 arcsec vs επίσημου swetest CGI Astrodienst
Κουπίδες οίκων Placidus: 0.000" ακριβής αντιστοιχία
Εκλείψεις: < 1 λεπτό vs NASA Eclipse Catalog
ACG γραμμές: < 1.5 χλμ στον ισημερινό vs swetest
Ανατολή/Δύση Ηλίου: < 10 δευτερόλεπτα vs timeanddate.com
Σελήνη VOC, εισόδους, πλανητικές συνδέσεις: ακρίβεια μέχρι το τμήμα του δευτερολέπτου

Κινητήρας

Στοιχείο	Τιμή
Βιβλιοθήκη	Swiss Ephemeris C code (aloistr/swisseph)
Έκδοση	upstream Astrodienst C code
Δέσμες	swisseph-wasm (WebAssembly στο Node.js)
Εφημερίδα	DE431 JPL εφημερίδα (μέσω αρχείων .se1)
Αναπλήρωση	Moshier αναλυτική (για ημερομηνίες εκτός 1800-2399)
Κώδικας κοινής χρήσης	Shared `@/core` με app.astroway.info — ένας κινητήρας, δύο μεταφορείς

Μεθοδολογία

Η ακρίβεια ελέγχεται μέσω τριγωνομετρίας — σύγκρισης με τρία ανεξάρτητα μέσα:

1. swetest CGI (πρότυπο)

Επίσημη υλοποίηση αναφοράς Swiss Ephemeris από τους ίδιους τους Astrodienst — την ομάδα που δημιούργησε το Astro.com και εξυπηρετεί εκατομμύρια αστρολόγους σε όλο τον κόσμο. Η πιο авторитетική δημόσια πηγή. Ο κινητήρας μας ταυτίζεται (0.00–0.07 κωνική δευτερολέπτου διαφορά).

2. Kerykeion (Python)

Ανεξάρτητη Python-βιβλιοθήκη χρησιμοποιεί pyswisseph-δέσμες αντί για τη δική μας WASM. Επιβεβαιώνει ότι το WASM-στρώμα μας δεν στρεβλώνει τα δεδομένα.

3. Prokerala API

Απώλεια Swiss Ephemeris API (sidereal Lahiri). Συστηματική διαφορά 8–17 κωνικών δευτερολέπτων σχετίζεται με διαφορετικές εκδόσεις της формούλας Lahiri ayanamsa, και όχι με την ακρίβεια του κινητήρα.

Αποτελέσματα τριγωνομετρίας

Χάρτης	έναντι swetest (Astrodienst)	έναντι Kerykeion (Python)	έναντι Prokerala API
Monroe 1926	0.00”	0.19”	16.95” (συστηματική)
Diana 1961	0.00”	0.69”	8.18” (συστηματική)
Einstein 1879	0.07”	LMT-αρτεφάκτο Kerykeion	14.96” (συστηματική)

Συνδυασμός σε επίπεδο τελικών σημείων

Κάθε βασικό σημείο υπολογισμού καλύπτεται από παγωμένα snapshot-тест σε 3 αναφορικές χάρτες (Monroe / Diana / Einstein) = 818 snapshot.

Το σύνολο snapshot-πιάτων πιάνει:

Σφάλματα χαρτογράφησης εισόδου — λάθος id πλανήτη, UT, σύστημα οίκων
Μετα-επεξεργασία — στρογγυλοποίηση, μετατροπή μονάδων, απώλεια σημείου
Διαφορά προεπιλογών — μέσο vs αληθινό σημείο, γεωκεντρικό vs τοποκεντρικό
Διακύμανση σχήματος — επικύρωση пропущθέντος λάθους μορφής
Παλιός εξοπλισμός — prod dist δεν αντιστοιχεί στον κώδικα

Ανοχή: 5e-5° (≈0.18 κωνική δευτερολέπτου) για όλα τα αριθμητικά πεδία.

Λεπτομερείς αναλύσεις

Θέσεις πλανητών (τροπικός, έναντι swetest)

Χάρτης	Ημερομηνία	Μέγιστη διαφορά
Marilyn Monroe	1926-06-01	0.00”
Princess Diana	1961-07-01	0.00”
Albert Einstein	1879-03-14	0.07”

Κουπίδες οίκων Placidus (ενάντια swetest)

Χάρτης	διαφορά ASC	διαφορά MC	Μέγιστη διαφορά κουπίδας
Monroe	0.000”	0.000”	0.000”
Diana	0.000”	0.000”	0.000”

Εκλείψεις (ενάντια NASA 5-Millennium Catalog)

Γεγονός	Μέγιστη NASA	Η μέγιστη μας	Διαφορά
2025-03-14 Lunar Total	06:58 UT	06:58 UT	0.8 λεπτά
2025-03-29 Solar Partial	10:47 UT	10:47 UT	0.5 λεπτά
2025-09-07 Lunar Total	18:11 UT	18:11 UT	0.8 λεπτά
2025-09-21 Solar Partial	19:41 UT	19:42 UT	1.0 λεπτό

Αστροχαρτογράφηση (ενάντια формуλάς RA από swetest)

Όλες οι γραμμές MC/IC/ASC/DSC χρησιμοποιούν τη σωστή формуλά longitude = RA − GMST (πρότυπο Kenneth Bowser). Διαφορά από το πρότυπο: < 1.5 χλμ στον ισημερινό για όλους τους πλανήτες.

Ανατολή/Δύση Ηλίου (ενάντια timeanddate.com)

Τοποθεσία	Ημερομηνία	Παράμετρος	Διαφορά
London	2026-04-15	Ανατολή	0.6 δευτερόλεπτα
London	2026-04-15	Δύση	9 δευτερόλεπτα

Πολικές τοποθεσίες (|lat| > 66.5°) επιστρέφουν αυτόματα polarState + πρόβλεψη ότι οι συνήθεις πλανητικές ώρες δεν ορίζονται.

Περιφέρειες ασπектών

AstroWay χρησιμοποιεί μεταβλητές περιφέρειες per-planet (κανόνα MIN δύο πλανητών), όπως στο ZET9 και astro.com. Περιφέρειες για προεπιλογή (για γενέθλια χάρτη):

Ασπект	Ήλιος	Σελήνη	Εσωτερικός	Δίας	Εξωτερικός
Σύνοδος	12°	10°	5°	8°	5°
Εξάγωνο	6.5°	6°	5°	5°	5°
Τετράγωνο	10°	8°	5°	7°	5°
Τρίγωνο	12°	8°	5°	5°	5°
Αντιπαράθεση	12°	10°	5°	8°	5°

Μικροί ασπектί (36°, 40°, 45°, 72°, 108°, 135°, 144°) για προεπιλογή απενεργοποιούνται. Ενεργοποιούνται ρητά μέσω ALL_ASPECTS.

Πολικές γεωγραφικές πλάτη

Για |lat| > 66.5°, οι συστήματα Placidus / Koch / Regiomontanus δεν ορίζονται μαθηματικά. Σε τέτοιες περιπτώσεις, ο Swiss Ephemeris επιστρέφει αυτόματα Porphyry, και η API μας προσθέτει μια πρόβλεψη:

{
  "system": "P",
  "warning": "Το σύστημα Placidus δεν ορίζεται για lat=68.96° (> 66.5°). Ο Swiss Ephemeris αντικατέστησε με Porphyry..."
}

Συνεχής έλεγχος

Regression ελέγχεται σε κάθε PR μέσω CI:

api-calc/tests/endpoints/ — 818 snapshot-πιάτων έναντι αναφορικών χαρτών (Monroe / Diana / Einstein) + synastry / composite / davison
.github/workflows/api-accuracy.yml — αυτοεκτέλεση σε PR
Τριγωνομετρία έναντι swetest CGI + Kerykeion — κάθε εβδομάδα
Παρακολούθηση upstream Swiss Ephemeris μέσω Dependabot

Γνωστά περιορισμένα

Ημερομηνίες εκτός εύρους (πριν από 1800 και μετά 2399): χρησιμοποιείται Moshier αναλυτική, ακρίβεια ~0.1” (ενάντια < 0.01” για SWIEPH με αρχεία DE431)
Αληθινή Λίλιθ (id=13) vs Μέση Λίλιθ (id=12): διαφορά μέχρι 12° — για προεπιλογή Μέση Λίλιθ (σταθερή συμπεριφορά), Αληθινή Λίλιθ διαθέσιμη μέσω planetIds: [13]
Τοποκεντρικό vs γεωκεντρικό: για προεπιλογή γεωκεντρικό