piv_sample_at_windows — PIV assess op

• Datenarten: flow2d → flow2d

• Aufruf: import fullseye as fs; fs.ledger.piv_sample_at_windows(field, info) (die Implementierung direkt: import pivops; pivops.piv_sample_at_windows(field, info); aus dem Register: opspiv.get("piv_sample_at_windows"))

Verwendung

Überträgt ein pixelweises Feld (2, H, W) auf das Gitter der Fenstermittelpunkte (nächster Nachbar).

Die Ground Truth wird in Pixelauflösung erzeugt, die PIV-Ausgabe liegt aber auf dem Fenstergitter. Vor dem Vergleich muss sie auf dasselbe Gitter gebracht werden, und die Art, wie das geschieht (nächster Nachbar oder Fenstermittel), verändert den Fehler. Hier: nächster Nachbar —— mit dem Fenstermittel wäre es in Feldern mit Gradienten nicht mehr von der eigenen Glättung von PIV zu unterscheiden.

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_river_surface_velocity — py -3.11 examples/poc_river_surface_velocity.py

• poc_strain_history — py -3.11 examples/poc_strain_history.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 (assess)

piv_error_stats · piv_peak_locking · piv_time_statistics


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

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