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.