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 自動產生(請勿手動編輯)。*

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