sun_at — DRIVE `env` op

• Data kinds: any × scalar × scalar → table

• Call: import fullseye as fs; fs.ledger.sun_at(when, lat: 'float', lon: 'float', *, refraction: 'bool' = True) -> 'Dict[str, float]' (to call the implementation directly, import driveenv; driveenv.sun_at(when, lat: 'float', lon: 'float', *, refraction: 'bool' = True) -> 'Dict[str, float]'; from the registry, opsdrive.get("sun_at"))

Usage

Solar altitude and azimuth for a date/time (a timezone-aware datetime or a Julian day). The formulas are taken as is from geocam.sun_position (NOAA solar position equations = low-precision version of Meeus "Astronomical Algorithms" Chapter 25, NOAA refraction), adding the date/time handling and the Earth–Sun distance.

Returns

dict : elevation (degrees; with refraction, the apparent elevation including atmospheric refraction), elevation_geometric, azimuth (degrees clockwise from north),

declination, eq_time (equation of time, minutes), hour_angle (degrees), jd, distance_au, semidiameter (degrees).

The accuracy NOAA states is within 1 minute for sunrise/sunset times within ±72° latitude (years 1800 to 2100).

Raises ValueError: naive datetime, latitude/longitude out of range.

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_events · 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).*

sun_at — DRIVE env op