correlation_score — REPRCONV `score` op

• Datenarten: voxel × voxel → score

• Aufruf: import fullseye as fs; fs.ledger.correlation_score(voxel_a, voxel_b) (die Implementierung direkt: import reprconv; reprconv.correlation_score(voxel_a, voxel_b); aus dem Register: opsreprconv.get("correlation_score"))

Verwendung

Zwei voxel → ein normiertes Kreuzkorrelations-score-Volumen. Der einzige Eingang in diesen Typ.

score ist ein Typ, den refine_peak_newton konsumiert, aber kein op im Register hat score erzeugt (gemessen; erreicht wurde er erst, nachdem eine Generator-Saat gesetzt war). Hier wird die zirkuläre Kreuzkorrelation per FFT zurückgegeben:

score[s] = sum_x (a[x] - mean_a) * (b[x + s] - mean_b) / (N * std_a * std_b)

Ist b also a, per np.roll um s0 verschoben, steht der Peak exakt bei s0 (Ground Truth in geschlossener Form; der Test nutzt das). Da es eine zirkuläre Korrelation ist, werden die Ränder umgeschlagen -- ausdrücklich: Es ist keine abgeschnittene Korrelation.

Args:

voxel_a: (D, H, W).

voxel_b: (D, H, W), gleiche Form wie voxel_a.

Returns:

(D, H, W) float64, Wertebereich etwa [-1, 1] (1.0 bei perfekter Übereinstimmung).

Raises:

ValueError: nicht 3-D / Formen verschieden / konstantes Volumen (Standardabweichung 0) / nicht endlich.

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.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

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

• poc_leak_localization — py -3.11 examples/poc_leak_localization.py

• representation_conversion — py -3.11 examples/representation_conversion.py

• representation_roundtrip — py -3.11 examples/representation_roundtrip.py

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

score_to_position · score_to_image2d

Gleiche Kategorie (`score`)

score_to_position · score_to_image2d

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

correlation_score — REPRCONV score op