sun_events — DRIVE env op

• Data kinds: scalar × scalar × scalar × scalar × scalar → table

• Call: 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]' (to call the implementation directly, 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]'; from the registry, opsdrive.get("sun_events"))

Usage

> This operator's description has not been translated yet. The original text follows as it is.

その日(地方の暦日)の日の出・南中・日の入りの時刻と、日の出入りの方位・南中の高度。

日の出入り = 太陽の中心の 幾何の 高度が `h0`(既定 −0.8333° = 大気差 34′ + 視半径 16′、上辺が地平線に接する)を

横切る時刻。`h0="naoj"` で国立天文台 暦計算室の定義(太陽の上辺が視地平線、地平大気差 35′8″、視半径は距離から)。

南中 = 時角 0。どちらも sun_at を時刻について解く(二分法、1e-6 日 ≈ 0.1 秒まで)。

Returns

-------

dict : `sunrise / transit / sunset`(タイムゾーンつき datetime、日の出入りが無ければ None)、

`sunrise_azimuth / sunset_azimuth(度)、transit_altitude(度、大気差なしの幾何の高度と、transit_altitude_apparent`)。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_driving_weather — py -3.11 examples/poc_driving_weather.py

Ops the type connects to (they accept table as input)

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

Same category (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. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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