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 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

sun_pixel_position — GEOCAM sun op

用法