sun_events — DRIVE env op

• Datenarten: scalar × scalar × scalar × scalar × scalar → table

• Aufruf: import fullseye as fs; fs.ledger.sun_events(year: 'int', month: 'int', day: 'int', lat: 'float', lon: 'float', tz_hours: 'float' = 9.0, *, h0: 'float' = -0.8333) -> 'Dict[str, object]' (die Implementierung direkt: import driveenv; driveenv.sun_events(year: 'int', month: 'int', day: 'int', lat: 'float', lon: 'float', tz_hours: 'float' = 9.0, *, h0: 'float' = -0.8333) -> 'Dict[str, object]'; aus dem Register: opsdrive.get("sun_events"))

Verwendung

Zeiten von Sonnenaufgang, Sonnenhöchststand und Sonnenuntergang des Tages (lokales Kalenderdatum) sowie Azimut von Auf- und Untergang und Höhe beim Höchststand.

Auf-/Untergang = der Zeitpunkt, zu dem die geometrische Höhe des Sonnenmittelpunkts h0 kreuzt (Standard −0.8333° = Refraktion 34′ + Halbmesser 16′, Oberrand berührt den Horizont). h0="naoj" verwendet die Definition des Ephemeridenbüros des National Astronomical Observatory of Japan (Oberrand der Sonne am scheinbaren Horizont, Horizontalrefraktion 35′8″, Halbmesser aus der Entfernung). Kulmination = Stundenwinkel 0. Beide werden durch Lösen von sun_at in der Zeit bestimmt (Bisektion, bis 1e-6 Tag ≈ 0.1 s).

Returns

dict : sunrise / transit / sunset (datetime mit Zeitzone, None, wenn es keinen Auf-/Untergang gibt),

sunrise_azimuth / sunset_azimuth (Grad), transit_altitude (Grad, geometrische Höhe ohne Refraktion, sowie transit_altitude_apparent).

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_driving_weather — py -3.11 examples/poc_driving_weather.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

Gleiche Kategorie (env)

julian_day · sun_at · sun_vector · sun_illuminance · koschmieder · mor_from_beta · beta_from_mor · road_row_distance


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.