piv_ensemble_correlate — PIV `estimate` op

• Datenarten: images → flow2d

• Aufruf: import fullseye as fs; fs.ledger.piv_ensemble_correlate(images, window=32, overlap=0.5, peak='gauss3', window_func='hann', normalize='overlap', search_limit=0.25) (die Implementierung direkt: import pivops; pivops.piv_ensemble_correlate(images, window=32, overlap=0.5, peak='gauss3', window_func='hann', normalize='overlap', search_limit=0.25); aus dem Register: opspiv.get("piv_ensemble_correlate"))

• Rückgabewert über das Register: fullseye.ledger.piv_ensemble_correlate(...) liefert nur den Wert des deklarierten Out-Typs flow2d (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.piv_ensemble_correlate.raw(...) oder rufe pivops.piv_ensemble_correlate direkt auf.

• Rückgabe der Funktion: (flow, info) -> flow2d

Verwendung

Sucht den Peak nach dem Aufsummieren der Korrelationskarten (Ensemble-Korrelation).

Bei wenigen Partikeln oder viel Rauschen ergibt paarweises Messen und Mitteln das Mittel falscher Vektoren. Addiert man auf der Korrelationsstufe, stapeln sich schwache Gipfel an derselben Stelle und heben sich ab. Voraussetzung ist eine stationäre Strömung (gleiche Verschiebung in allen Paaren).

Args:

images: Folge von 2 oder mehr Bildern. Aufeinanderfolgende Paare (k, k+1) werden verwendet.

window / overlap / peak / window_func / normalize / search_limit:

wie piv_cross_correlate.

Returns:

(flow (2, h, w), info). info["pairs"] enthält die Anzahl der verwendeten Paare.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie piv_displacement

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)

• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py

• poc_river_surface_velocity — py -3.11 examples/poc_river_surface_velocity.py

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

piv_deform_pass · piv_outlier_mask · piv_replace_outliers · piv_vorticity · piv_divergence · piv_flow_magnitude · piv_to_velocity · piv_velocity_gradient

Gleiche Kategorie (`estimate`)

piv_cross_correlate · piv_multipass · piv_deform_pass

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

piv_ensemble_correlate — PIV estimate op