piv_vorticity — PIV field op

• Datenarten: flow2d → image2d

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

Verwendung

Wirbelstärke d(dx)/dy - d(dy)/dx. Gegen den Uhrzeigersinn ist positiv (Definition in Bildkoordinaten).

In Bildkoordinaten, in denen die Zeilen nach unten zunehmen, sind oben und unten gegenüber mathematischen xy-Koordinaten vertauscht. Schreibt man dies, ohne das Vorzeichen festzulegen, kehrt sich der Drehsinn von Wirbeln still um; daher ist die Definition im docstring festgeschrieben.

Args:

flow: (2, h, w).

spacing: Abstand benachbarter Vektoren [px] (info["step"]).

Returns:

(h, w). Einheit 1/Frame (wenn spacing in Pixeln ist).

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_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py

• poc_tactile_dipole_torque — py -3.11 examples/poc_tactile_dipole_torque.py

• poc_what_a_picture_cannot_check — py -3.11 examples/poc_what_a_picture_cannot_check.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_divergence · piv_flow_magnitude · piv_to_velocity · piv_velocity_gradient · piv_q_criterion · 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.