piv_synth_pair — PIV `synth` op

• Datenarten: keine → image2d (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

• Aufruf: import fullseye as fs; fs.ledger.piv_synth_pair(shape, displacement, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0) (die Implementierung direkt: import pivops; pivops.piv_synth_pair(shape, displacement, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0); aus dem Register: opspiv.get("piv_synth_pair"))

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

• Rückgabe der Funktion: (a, b, truth) -> image2d

Verwendung

Erzeugt ein Bildpaar mit bekanntem Verschiebungsfeld. Rückgabe: (image_a, image_b, truth).

Die Partikel werden bewegt und dann das 2. Bild gezeichnet (das 1. Bild wird nicht per Interpolation verzerrt). Per Interpolation erzeugt, würde die Glättung der Interpolation "ein Bild, das PIV leicht trifft" erzeugen, und man würde die eigene Implementierung an für sie günstigen Eingaben messen.

Args:

shape: (H, W).

displacement: Art der Verschiebungsvorgabe. Eine der folgenden.

• Folge der Länge 2 —— gleichförmige Translation (dy, dx) [px].

• callable(rows, cols) -> (dy, dx) —— ein positionsabhängiges Feld. Die Argumente sind Arrays der kontinuierlichen Partikelkoordinaten.

density / diameter_px / seed / intensity / background: wie piv_synth_particles.

noise_sigma: Standardabweichung des additiven Gaußrauschens, unabhängig zu jedem der 2 Bilder addiert.

Returns:

(a (H, W), b (H, W), truth (2, H, W)). truth ist die pro Pixel

wahre Verschiebung; um sie auf das Fenstergitter zu bringen, piv_sample_at_windows verwenden.

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

• piv_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py

• poc_strain_history — py -3.11 examples/poc_strain_history.py

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

piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality

Gleiche Kategorie (`synth`)

piv_synth_particles · piv_synth_sequence

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

piv_synth_pair — PIV synth op