piv_q_criterion — PIV field op

• Datenarten: flow2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.piv_q_criterion(flow, spacing=1.0) (die Implementierung direkt: import pivops; pivops.piv_q_criterion(flow, spacing=1.0); aus dem Register: opspiv.get("piv_q_criterion"))

Verwendung

Q-Kriterium -tr(J^2)/2. Es ist positiv, wo die Rotation die Verzerrung übersteigt.

Betrachtet man nur die Wirbelstärke, leuchten auch Scherschichten auf (der wandnahe Bereich einer laminaren Strömung sieht wie ein Wirbel aus); zur Wirbelextraktion daher dieses verwenden. Geschlossene Form (gemessen mit direkt vorgegebenen analytischen Feldern):

• Starrkörperrotation ω=0.01 → +1.0e-4 (= ω^2)

• gleichförmige Expansion s=0.01 → -1.0e-4 (= -s^2)

• einfache Scherung g=0.02 → 0.0 (Scherung ist kein Wirbel ist der Kern)

★ Es ist eine Größe, die eine Schwelle erfordert. Q > 0 allein erfasst auch schwache Bereiche; daher verbirgt eine Wirbelvisualisierung, die nicht angibt, wie die Schwelle gewählt wurde, die Möglichkeit, dass die Schönheit des Bildes ein Produkt der Schwelle ist. Die Flächenänderung bei variierter Schwelle mit angeben.

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

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality

Gleiche Kategorie (field)

piv_vorticity · piv_divergence · piv_flow_magnitude · piv_to_velocity · piv_velocity_gradient · piv_swirling_strength · piv_strain_rate


*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.