sun_position — GEOCAM `sun` op

• Datenarten: signal → table

• Aufruf: import fullseye as fs; fs.ledger.sun_position(lat_deg, lon_deg, unix_times) (die Implementierung direkt: import geocam; geocam.sun_position(lat_deg, lon_deg, unix_times); aus dem Register: opsgeocam.get("sun_position"))

Verwendung

Breite, Länge, Zeitpunkt (UNIX-Sekunden, UTC) → Azimut und Elevation der Sonne [Grad] (NOAA-Sonnenstandsalgorithmus, die Formel geringer Genauigkeit nach Meeus 1998).

Eine veröffentlichte geschlossene Form (dieselben Formeln wie der Solar Calculator des NOAA Global Monitoring Laboratory:

julianisches Jahrhundert → mittlere Länge, mittlere Anomalie, Mittelpunktsgleichung → scheinbare Länge → Schiefe der Ekliptik → Deklination und Zeitgleichung → Stundenwinkel → Zenitwinkel, Azimut). Die Genauigkeit beträgt etwa 0.01° für 2000 ± 1 Jahrhundert (Angabe der NOAA); die atmosphärische Refraktion wird zur Elevation addiert (stückweise Formel der NOAA, maximal 0.57° nahe dem Horizont). Zeiten sind UNIX-Sekunden in UTC (1-D, float ist in Ordnung). Schaltsekunden und ΔT werden ignoriert (sie spielen bei 0.01° keine Rolle).

Args:

lat_deg, lon_deg: Beobachtungspunkt. Längengrad ist nach Osten positiv.

unix_times: (N,) UNIX-Sekunden (UTC). Ein Skalar ist ebenfalls möglich.

Returns:

table: azimuth_deg (N,) (Nord 0°, im Uhrzeigersinn) / elevation_deg (N,) (mit Refraktion) /

elevation_true_deg (N,) (ohne Refraktion) / declination_deg / equation_of_time_min /

hour_angle_deg / n.

Gegen Ground Truth geprüfte Eigenschaften (tests/test_geocam.py): Mittags zur Tagundnachtgleiche ist die Elevation = 90 − |Breite|; das Mittagsazimut auf der Nordhalbkugel ist 180° (Süd); das Azimut verläuft monoton Ost → Süd → West; die Elevationen von Sonnenaufgang und Sonnenuntergang sind symmetrisch; die Deklination bleibt innerhalb von ±23.44°.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie geocam

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_public_camera_heading — py -3.11 examples/poc_public_camera_heading.py

• poc_public_camera_heading_real — py -3.11 examples/poc_public_camera_heading_real.py

Typkompatible Folge-Operatoren (nehmen `table` als Eingabe)

render_skyline_view · camera_orientation_from_skyline

Gleiche Kategorie (`sun`)

sun_pixel_position · camera_orientation_from_sun · sun_bloom_fit · camera_orientation_from_sun_candidates

*Provenance: geocam.py — GEOCAM Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

sun_position — GEOCAM sun op