registration_recall — 3D registration_metrics op

• Data kinds: points × points → measurement

• Call: import fullseye as fs; fs.ledger.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float' (implementation को सीधे call करना हो तो import registration_eval; registration_eval.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float', registry से लेना हो तो ops3d.get("registration_recall"))

उपयोग

3DMatch शैली का per-pair registration सफलता/असफलता = 1.0 (सफल) / 0.0 (असफल)।

GT transform gt_transform से source को target frame में ले जाकर, target की ओर के nearest neighbour (दूरी < corr_thresh, default thresh) को GT correspondence (= overlap) के रूप में जोड़ा जाता है। उन correspondences को estimated transform est_transform से ले जाने पर RMSE यदि thresh से कम हो तो सफलता।

source/target का index correspondence होना ज़रूरी नहीं (correspondence GT से बनती है, इसलिए यह target के क्रम पर निर्भर नहीं करती)। GT overlap का 1 भी point न हो तो सफलता/असफलता undefined है → nan (honest)। पूरे dataset का Registration Recall इस per-pair metric (overlap वाली pairs पर) का औसत है। shape अमान्य हो तो ValueError (fail-closed)।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• reg_eval — py -3.11 examples_3d/reg_eval.py

वे अगले ops जिनसे type जुड़ता है (measurement को input के रूप में लेते हैं)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

इसी category के (registration_metrics)

inlier_ratio · rmse_inliers · rotation_translation_error


*Provenance: registration_eval.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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