sun_pixel_position — GEOCAM `sun` op

• 데이터 종류: image2d → keypoints

• 호출: import fullseye as fs; fs.ledger.sun_pixel_position(image, threshold=0.98, min_area=4)(구현을 직접 호출하려면 import geocam; geocam.sun_pixel_position(image, threshold=0.98, min_area=4), 원장에서 가져오려면 opsgeocam.get("sun_pixel_position"))

사용법

> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.

画像の中の太陽(センサを飽和させる円盤)の重心 → keypoints (1, 2) = (u, v)。

前提は「太陽はセンサを飽和させ、雲や雪は飽和の手前で止まる」。値が `threshold`(絶対値、

画像は 0〜1)以上の画素を 8 近傍で連結し、最大の塊の輝度重心を返す。塊が `min_area` 未満、

または飽和画素が無ければ「太陽が写っていない」として ValueError(黙って雲の反射を返さない —— 太陽が

山に隠れた時刻の写真で、雲を太陽と読んで姿勢を汚さないための門)。**画像の最大値に対する比では

ない**(比にすると、太陽の無い写真で一番明るい雲が必ず「太陽」になる)。夜景の人工光源や

太陽の水面反射は飽和しうるので、その場面では使えない。塊は詰まった丸であること(充填率 ≥ 0.4、

縦横比 ≤ 2.5)—— 露出過多で空の帯が飽和した写真は細長い塊になり、拒否される。

Args:

image: (H, W) float、0〜1(範囲外は ValueError)。

threshold: 飽和とみなす絶対値(既定 0.98)。

min_area: 塊の最小画素数。

Returns:

keypoints (1, 2) float: (u, v)。

자세한 사용 가이드

• 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

타입이 이어지는 다음 연산자(`keypoints` 를 입력으로 받는 것)

camera_orientation_from_sun · camera_orientation_from_sun_candidates

같은 카테고리(`sun`)

sun_position · camera_orientation_from_sun · sun_bloom_fit · camera_orientation_from_sun_candidates

*Provenance: geocam.py — GEOCAM 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

sun_pixel_position — GEOCAM sun op

사용법