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 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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