sun_at — DRIVE env op

• 資料種類:any × scalar × scalar → table

• 呼叫: import fullseye as fs; fs.ledger.sun_at(when, lat: 'float', lon: 'float', *, refraction: 'bool' = True) -> 'Dict[str, float]'(要直接呼叫實作,import driveenv; driveenv.sun_at(when, lat: 'float', lon: 'float', *, refraction: 'bool' = True) -> 'Dict[str, float]';從台帳取用則 opsdrive.get("sun_at"))

用法

給定日期時間(帶時區的 datetime 或儒略日)的太陽高度角與方位角。公式直接使用 geocam.sun_position(NOAA 太陽位置公式 = Meeus "Astronomical Algorithms" 第 25 章的低精度版,NOAA 大氣折射),另加日期時間的接收方式與日地距離。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

Returns

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

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

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

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

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_driving_weather — py -3.11 examples/poc_driving_weather.py

型別可銜接的下一個運算子(可接受 table 作為輸入)

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

同類別(env)

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


*Provenance: driveenv.py — DRIVE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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