keypoints_from_image2d — REPRCONV keypoint op

• 資料種類:image2d → keypoints

• 呼叫: import fullseye as fs; fs.ledger.keypoints_from_image2d(image2d, threshold=0.0)(要直接呼叫實作,import reprconv; reprconv.keypoints_from_image2d(image2d, threshold=0.0);從台帳取用則 opsreprconv.get("keypoints_from_image2d"))

用法

計數/響應影像 (H, W) → 影像座標 (N,2) = (u, v)。往返的回程。

把 > threshold 的像素依 8 鄰域分成連通元件,回傳各元件的強度加權質心。之所以加權,是為了在保留次像素資訊的響應影像(相關峰等)上能把往返誤差降到量化以下。

注意 8 鄰域連通是損失的主犯: 落在相鄰像素上的 2 個點會融合為 1 個元件,質心移到 2 點的中間。selftest 把「僅相互遠離的點的量化誤差」與「含融合的整體」分開量測(混在一起就無法與量化的理論值 0.2887 px 比較)。

Args:

image2d: (H, W) 的實數影像。

threshold: 只拾取超過此值的像素。

Returns:

(N, 2) float64 的 (u, v)。列順序為 scipy.ndimage.label 的標籤順序。

Raises:

ValueError: 不是 2-D / 非有限 / 連 1 個超過閾值的像素都沒有。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• representation_roundtrip — py -3.11 examples/representation_roundtrip.py

型別可銜接的下一個運算子(可接受 keypoints 作為輸入)

keypoints_uv_to_points · keypoints_to_image2d

同類別(keypoint)

keypoints_uv_to_points · points_zyx_to_keypoints_uv · keypoints_to_image2d · position_to_points · points_to_position

*Provenance: reprconv.py — REPRCONV 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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