registration_recall — 3D `registration_metrics` op

• Datenarten: points × points → measurement

• Aufruf: import fullseye as fs; fs.ledger.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float' (die Implementierung direkt: import registration_eval; registration_eval.registration_recall(source, target, gt_transform, est_transform, thresh: 'float', *, corr_thresh: 'float | None' = None) -> 'float'; aus dem Register: ops3d.get("registration_recall"))

Verwendung

Registrierungserfolg je Paar im 3DMatch-Stil = 1,0 (Erfolg) / 0,0 (Misserfolg).

Mit der GT-Transformation gt_transform wird source in das target-Koordinatensystem abgebildet, und die nächsten Nachbarn auf der target-Seite (Abstand < corr_thresh, Standard thresh) werden als GT-Korrespondenzen (= Überlappung) gesetzt. Unterschreitet der RMSE dieser Korrespondenzen, abgebildet mit der geschätzten Transformation est_transform, den Wert thresh, ist es ein Erfolg.

source/target müssen nicht index-korrespondierend sein (die Korrespondenzen werden aus der GT gebildet und hängen daher nicht von der Reihenfolge von target ab). Gibt es nicht einmal 1 GT-Überlappungspunkt, ist Erfolg undefiniert → nan (honest). Die Registration Recall eines ganzen Datensatzes ist der Mittelwert dieser per-pair-Kennzahl (über Paare mit Überlappung). Ungültige Formen ergeben ValueError (fail-closed).

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• reg_eval — py -3.11 examples_3d/reg_eval.py

Typkompatible Folge-Operatoren (nehmen `measurement` als Eingabe)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

Gleiche Kategorie (`registration_metrics`)

inlier_ratio · rmse_inliers · rotation_translation_error

*Provenance: registration_eval.py — 3D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

registration_recall — 3D registration_metrics op