pairs_to_image2d — REPRCONV pairs op

• 資料種類:pairs → image2d

• 呼叫: import fullseye as fs; fs.ledger.pairs_to_image2d(pairs, shape=(64, 64))(要直接呼叫實作,import reprconv; reprconv.pairs_to_image2d(pairs, shape=(64, 64));從台帳取用則 opsreprconv.get("pairs_to_image2d"))

用法

對 (N,2) → 散點密度影像 (H, W)。pairs 的第三個出口。

將行 0 對應到列方向、行 1 對應到行方向,各自以最小-最大正規化後落入 bin (2-D 直方圖)。用於當作相位圖、相關圖檢視,不可逆 (bin 寬度的量化 + 正規化會捨棄絕對值的尺度)。為了能還原被捨棄的尺度而回傳 extent……並不這麼做 —— 一旦回傳就不再是 image2d

了。如有需要,請使用 pairs_to_table 的 x_min 等。

常數行(最小 == 最大)集中到 0.5 的位置(避免除以 0,但為了不被解讀為「密度集中在中央」,只立起 1 個 bin)。

Args:

pairs: (N, 2)。

shape: (H, W)。

Returns:

(H, W) float64,正規化到最大值 1.0 的密度。

Raises:

ValueError: 形狀不正確 / 非有限 / shape 超過上限。

參考(範例資料、文獻)

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

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

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

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

• representation_conversion — py -3.11 examples/representation_conversion.py

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

keypoints_from_image2d

同類別(pairs)

pairs_to_signal · pairs_to_table

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

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