sun_position — GEOCAM `sun` op

• 資料種類:signal → table

• 呼叫: import fullseye as fs; fs.ledger.sun_position(lat_deg, lon_deg, unix_times)(要直接呼叫實作,import geocam; geocam.sun_position(lat_deg, lon_deg, unix_times);從台帳取用則 opsgeocam.get("sun_position"))

用法

緯度、經度、時刻(UNIX 秒，UTC)→ 太陽的方位角、仰角 [度] (NOAA 太陽位置演算法，Meeus 1998 的低精度公式)。

公開的閉合式(與 NOAA Global Monitoring Laboratory 的 Solar Calculator 相同的公式:

儒略世紀 → 平黃經、平近點角、中心差 → 視黃經 → 黃赤交角 → 赤緯與均時差 → 時角 → 天頂角、方位角)。精度在 2000 年 ± 1 世紀內為 0.01° 左右(NOAA 的說明), 大氣折射加到仰角上(NOAA 的分段公式,接近水平時最大 0.57°)。時刻為 UTC 的 UNIX 秒(1-D,float 即可)。忽略閏秒與 ΔT(對 0.01° 沒有影響)。

Args:

lat_deg, lon_deg: 觀測點。經度以東為正。

unix_times: (N,) UNIX 秒(UTC)。也可為純量。

Returns:

table: azimuth_deg (N,)(北 0°,順時針)/ elevation_deg (N,)(含折射)/

elevation_true_deg (N,)(不含折射)/ declination_deg / equation_of_time_min /

hour_angle_deg / n。

已用真值確認的性質(tests/test_geocam.py):春分正午仰角 = 90 − |緯度|, 北半球正午的方位為 180°(南),方位依東 → 南 → 西單調變化,日出與日落的仰角對稱,赤緯在 ±23.44° 以內。

詳細使用指南

• geocam 族使用指南

參考(範例資料、文獻)

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

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

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

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

• poc_public_camera_heading — py -3.11 examples/poc_public_camera_heading.py

• poc_public_camera_heading_real — py -3.11 examples/poc_public_camera_heading_real.py

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

render_skyline_view · camera_orientation_from_skyline

同類別(`sun`)

sun_pixel_position · camera_orientation_from_sun · sun_bloom_fit · camera_orientation_from_sun_candidates

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

sun_position — GEOCAM sun op

用法