EskimueandClaude Sonnet 5
5652cc7e40
Berechnet Bedeckungen der Planeten Merkur bis Neptun durch den Mond fuer ein ganzes Jahr am Standardstandort, inklusive Detailkarte. Ereignisse unter dem Horizont werden weiterhin angezeigt statt gefiltert, dafuer mit eigenem Sichtbarkeits-Hinweis. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
81 lines
4.6 KiB
Markdown
81 lines
4.6 KiB
Markdown
# Berechnungsgrundlagen
|
|
|
|
Stand: 12.09.2026
|
|
|
|
Diese Datei dokumentiert, welche Berechnungsbibliothek beziehungsweise welche
|
|
Datenquelle die einzelnen Seiten verwenden.
|
|
|
|
## Die drei wichtigsten Grundlagen
|
|
|
|
### Astronomy Engine
|
|
|
|
Die lokale Python-Version liegt in `public/py/astronomy.py`. Im Browser wird
|
|
`public/js/astronomy.browser.min.js` verwendet.
|
|
|
|
Astronomy Engine liefert auf vielen Seiten die Positionen von Sonne, Mond und
|
|
Planeten sowie Ereigniszeiten wie Mondphasen, Finsternisse, Bedeckungen und
|
|
Konjunktionen.
|
|
|
|
### Skyfield mit `de421.bsp`
|
|
|
|
Skyfield liegt lokal in `public/py/vendor` beziehungsweise
|
|
`public/py/vendor_linux`. Die verwendete JPL-Ephemeride ist:
|
|
|
|
`public/py/vendor_data/de421.bsp`
|
|
|
|
Die zentrale Einrichtung erfolgt in `public/py/astronomical_conversions.py`.
|
|
`de421.bsp` wird derzeit für die Planet-Ephemeriden in `ephemeriden_api.py`
|
|
und für die Dämmerungsgrafik verwendet.
|
|
|
|
Die Datei enthält Jupiter bis Neptun als Systemschwerpunkte. Die lokale
|
|
`jup365`-Datei wird von den hier dokumentierten Seiten derzeit nicht verwendet.
|
|
|
|
### Weitere Berechnungen
|
|
|
|
Nicht jede Berechnung ist Skyfield oder Astronomy Engine:
|
|
|
|
- Satellitenbahnen werden mit SGP4 aus TLE-Daten berechnet.
|
|
- Kometen und Kleinplaneten werden derzeit aus ihren Bahnelementen mit eigenen
|
|
Kepler-Berechnungen bestimmt.
|
|
|
|
## Seitenübersicht
|
|
|
|
| Seite | Berechnungsgrundlage |
|
|
|---|---|
|
|
| `ephemeriden.php` | **Skyfield + `de421.bsp`** für Sonne, Mond und Planeten. Auf- und Untergang sowie Horizontkoordinaten werden ebenfalls mit Skyfield berechnet. Kometen und Kleinplaneten bleiben bei den eigenen Bahnelement-Berechnungen. Die interaktive Karte nutzt im Browser zusätzlich Astronomy Engine für Horizontberechnungen und Sterne. |
|
|
| `monatsvorhersage.php` | Überwiegend **Astronomy Engine** über `public/py/api.py`. Satellitenereignisse verwenden SGP4. Die Dämmerungsgrafik verwendet Skyfield + `de421.bsp`. Jupiter- und Jupitermond-Ereignisse verwenden aktuell Astronomy Engine. |
|
|
| `wochenvorhersage.php` | **Astronomy Engine** über `public/py/api.py`; je nach Bereich zusätzlich SGP4 für Satelliten. |
|
|
| `jupitersystem.php` | **Astronomy Engine**. Die Darstellung im Browser und die Galileischen Monde werden über Astronomy Engine berechnet. `jup365.bsp` wird hier aktuell nicht geladen. |
|
|
| `sonnenfinsternis.php` | **Astronomy Engine**, einschließlich lokaler Berechnung für den Standardstandort. |
|
|
| `mondfinsternis.php` | **Astronomy Engine**. Der Zeitpunkt der Finsternis ist global; eine lokale Sichtbarkeitsbewertung ist davon getrennt. |
|
|
| `sternbedeckungen.php` | **Astronomy Engine** über die lokale Python-API. Topozentrische Koordinaten und der Standardstandort werden berücksichtigt. |
|
|
| `mondplanetenbedeckungen.php` | **Astronomy Engine** über die lokale Python-API. Durchsucht ein ganzes Jahr nach Mond-Planeten-Bedeckungen (Merkur bis Neptun) für den Standardstandort; berücksichtigt die scheinbare Scheibengröße von Mond und Planet. |
|
|
| `moonphase.php` | **Astronomy Engine** im Browser beziehungsweise über die lokale Python-API. |
|
|
| `moonyear.php` | **Astronomy Engine** für Mondphasen und Mondpositionen. |
|
|
| `satellitenhimmel.php` | **SGP4** für Satellitenbahnen; Astronomy Engine für astronomischen Kontext wie Sonne, Mond und Dämmerung. |
|
|
| `drehbare_sternkarte.php` | **Astronomy Engine** im Browser für Horizont- und Koordinatenberechnungen. |
|
|
| `sternenhimmel.php` | **Astronomy Engine** im Browser beziehungsweise über die lokale API. |
|
|
| `tagbogen.php` | **Astronomy Engine** für Sonnen-, Mond- und Planetenbahnen. |
|
|
| `solarsystem.php` | **Astronomy Engine** im Browser für das Sonnensystemmodell. |
|
|
| `geocron3d.php` | **Astronomy Engine** im Browser. |
|
|
| `geocron/index.php` | **Astronomy Engine** über das Geocron-Plugin. |
|
|
|
|
## Zentrale Python-Dateien
|
|
|
|
| Datei | Aufgabe |
|
|
|---|---|
|
|
| `public/py/api.py` | Allgemeine astronomische Ereignisse; überwiegend Astronomy Engine. Einzelne Dämmerungsberechnungen verwenden Skyfield. |
|
|
| `public/py/ephemeriden_api.py` | Planet-Ephemeriden mit Skyfield + `de421.bsp`; Kleinplaneten und Kometen mit eigenen Bahnelement-Berechnungen. |
|
|
| `public/py/astronomical_conversions.py` | Gemeinsame Skyfield-Konfiguration und Zugriff auf `de421.bsp`. |
|
|
| `public/py/astronomy.py` | Lokale Python-Version der Astronomy Engine. |
|
|
|
|
## Standort und Lichtlaufzeit
|
|
|
|
Wo eine Seite einen Standort benötigt, wird grundsätzlich der persönliche
|
|
Standardstandort des angemeldeten Benutzers verwendet. Fehlt dieser, greift
|
|
der konfigurierte Fallback-Standort.
|
|
|
|
Die Verwendung von Skyfield oder Astronomy Engine sagt allein noch nicht, ob
|
|
eine Berechnung topozentrisch, geozentrisch oder mit Lichtlaufzeit erfolgt.
|
|
Das ist je Ereignis in der jeweiligen Funktion festgelegt.
|