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]' (implementation को सीधे call करना हो तो import driveenv; driveenv.sun_at(when, lat: 'float', lon: 'float', *, refraction: 'bool' = True) -> 'Dict[str, float]', registry से लेना हो तो opsdrive.get("sun_at"))

उपयोग

दिनांक-समय (timezone वाला datetime या Julian day) पर सूर्य की ऊँचाई और azimuth। सूत्र geocam.sun_position (NOAA के सूर्य-स्थिति सूत्र = Meeus "Astronomical Algorithms" अध्याय 25 का कम-precision रूप, NOAA का atmospheric refraction) से जैसे के तैसे लिए गए हैं, दिनांक-समय लेने का तरीका और पृथ्वी–सूर्य की दूरी जोड़ी गई है।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Returns

dict : elevation(度、refraction なら大気差つきの見かけ)、elevation_geometric、azimuth(北から時計回り 度)、

declination、eq_time(均時差 分)、hour_angle(度)、jd、distance_au、semidiameter(度)。

NOAA が述べる精度は、日の出入りの時刻で緯度 ±72° 以内 1 分以内(1800〜2100 年)。

Raises ValueError: 素朴な datetime・範囲外の緯度経度。

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_driving_weather — py -3.11 examples/poc_driving_weather.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_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. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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