Worum geht’s?
Celestial Planner ist ein Planungs-Tool für Foto-/Video-Szenen. Du wählst einen Standpunkt und eine Zeit und bekommst dann:
- Azimut (Richtung) und Altitude (Höhe) von Sonne, Mond und optional GC (Galaktisches Zentrum/Milchstraße)
- Terrain-Sichtbarkeit: „sichtbar“ vs. „verdeckt“ durch Berge/Hügel (DEM-basiert)
- Höhenprofil als Querschnitt mit Sichtstrahl und Blocker-Markierung
- 24h-Höhenkurve (Altitude über Zeit) wie bei TPE – ohne Terrain in diesem Schritt
Alles läuft lokal im Browser. Karten & Terrain-Daten kommen über Mapbox.
Voraussetzungen
- Moderner Browser mit WebGL (Chrome/Edge/Firefox/Safari)
- Internetverbindung (Mapbox + externe JS-Libraries)
- Mapbox Access Token
Der Token wird lokal in localStorage gespeichert (nur in deinem Browser).
Schnellstart
- Token einfügen → Start
- Standpunkt setzen:
- Shift+Klick in die Karte (nach „Standpunkt setzen“)
- oder lat/lng eingeben → Übernehmen
- Datum/Uhrzeit setzen (lokal am Spot) + Zeitzonen-Offset prüfen
- Update drücken (oder Zeit-Slider/Timeline bewegen)
Wenn du außerhalb DE planst: Offset passend zum Datum eingeben (Sommerzeit!).
UI & Funktionen
Mapbox & Darstellung
- Style (Satellite/Dark/…)
- Terrain on/off
- Exaggeration (nur Optik)
- Refraction normal/none
- Max Distanz (Sichtprüfung + Profil)
Standpunkt & Sichtpunkt
- Standpunkt = Beobachterposition
- Sichtpunkt (optional) = Motiv/Gipfel als Referenz
- Shift+Klick übernimmt Koordinaten (je nach Modus)
Kamera / Quick View
- Am Boden: setzt FreeCamera möglichst auf Augenhöhe über Terrain
- Blick Sonne/Mond/Ziel: richtet Kamera grob aus
Zeitsteuerung
- datetime-local „Datum & Uhrzeit (lokal am Spot)“
- Zeitzonen-Offset (+01:00 etc.)
- Zeit-Slider (0–24h) + Tageslicht-Timeline oben in der Karte
- Jetzt + ±1 Tag
Anzeige-Modus (Himmelskörper)
Über „Anzeige“ steuerst du, welche Marker/Linien aktiv sind (Sonne/Mond/GC).
Rise/Set + Arc
Berechnet Auf-/Untergang (astronomisch) für Sonne/Mond am Tag und zeichnet den Bogen (Azimut-Verlauf) auf dem Ring.
Sichtbarkeit (sichtbar/verdeckt)
Der Check kombiniert Astro + Terrain:
- Astro: Azimut + Altitude des Körpers am Standpunkt/Zeitpunkt
- Terrain: Samples entlang des Azimuts bis Max Distanz
- Ergebnis: Horizonwinkel (max. Terrain-Winkel) + Blocker-Distanz
sichtbar, wenn Altitude > Horizonwinkel • verdeckt, wenn Altitude ≤ Horizonwinkel
Höhenprofil
Querschnitt entlang des Azimuts (Distanz → Winkel in °):
- Terrain-Kurve
- Sichtstrahl (Altitude-Linie)
- Horizontlinie (0°)
- Blocker-Punkt markiert
Das Profil nutzt exakt die gleichen Terrain-Samples wie der Visibility-Check (kein zweites Sampling).
24h Höhenkurve
- Checkboxen: Sonne/Mond/GC
- 24h berechnen: Astro-only (ohne Terrain)
- Standard: alle 10 Minuten über 24h
- Now-Marker folgt dem aktuellen Zeit-Slider
Die Berechnung läuft in kleinen Paketen (requestAnimationFrame), damit die Map nicht einfriert.
Presets
- Preset-Name → Speichern
- Aus Liste wählen → Laden
- Export/Import JSON für Backup/Transfer
Presets liegen lokal im Browser (localStorage).
Typische Anwendungsfälle
- Sunrise/Sunset hinter einem Gipfel planen (Standpunkt + Sichtpunkt)
- Mondaufgang am Bergkamm: sichtbar? Blocker-km? Höhenprofil zeigt den kritischen Kamm
- Milchstraße grob ausrichten: GC Az/Alt + 24h-Fenster
- Locations vergleichen: Presets pro Spot
Genauigkeit & Grenzen
- Terrain = Mapbox DEM (Auflösung/Qualität variiert je Region)
- Keine Bäume/Gebäude im Terrain-Modell
- Refraktion ist ein Modell (normal/none)
- Sehr entfernte Ketten nur bis „Max Distanz“
Das Tool ist ein Planungshelfer – kein Navigations-/Sicherheitsinstrument.
Troubleshooting
Keine Karte
- Token prüfen
- Internet/Adblocker prüfen (Mapbox/CDN)
Marker/Linien fehlen
- „Start“ gedrückt?
- Standpunkt + Datum/Uhrzeit gesetzt?
- Anzeige-Modus passend?
- einmal „Update“
Performance
- Terrain aus / Exaggeration runter
- Max Distanz kleiner
Datenschutz
- Tool läuft lokal im Browser.
- Kein eigener Server für Standpunkt-Daten.
- Mapbox lädt Karten/DEM über das Internet.
- Token/Presets lokal in
localStorage.