registration_recall — 3D registration_metrics op

• 資料種類:points × points → measurement

• 呼叫: import fullseye as fs; fs.ledger.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float'(要直接呼叫實作,import registration_eval; registration_eval.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float';從台帳取用則 ops3d.get("registration_recall"))

用法

3DMatch 風格的 per-pair 配準成敗 = 1.0(成功)/ 0.0(失敗)。

以 GT 變換 gt_transform 把 source 映射到 target 座標系，將 target 側的最近鄰（距離 < corr_thresh，預設為 thresh）作為 GT 對應（= 重疊）。若將這些對應以估計變換 est_transform 映射後的 RMSE 低於 thresh，則為成功。

source/target 不必依 index 對應（對應由 GT 建立，因此不依賴 target 的排列順序）。若 GT 重疊連 1 個點也沒有，則成敗未定義 → nan(honest)。整個資料集的 Registration Recall 是此 per-pair 指標（在有重疊的對上）的平均值。形狀不正確時拋出 ValueError(fail-closed)。

參考(範例資料、文獻)

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

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

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

• reg_eval — py -3.11 examples_3d/reg_eval.py

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

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

同類別(registration_metrics)

inlier_ratio · rmse_inliers · rotation_translation_error

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

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