piv_quiver — PIV `visualise` op

• Datenarten: flow2d → rgb

• Aufruf: import fullseye as fs; fs.ledger.piv_quiver(flow, spacing=None, scale=None, upsample=8, background=None, color=(0.08, 0.08, 0.12), width=1.5) (die Implementierung direkt: import pivops; pivops.piv_quiver(flow, spacing=None, scale=None, upsample=8, background=None, color=(0.08, 0.08, 0.12), width=1.5); aus dem Register: opspiv.get("piv_quiver"))

Verwendung

Pfeildiagramm (MATLABs quiver). Rückgabe ist (h*upsample, w*upsample, 3).

1 Pfeil pro spacing Gittereinheiten, Ursprung auf einem Gitterpunkt, Spitze gezogen bis Ursprung + scale * v. Ohne scale wird der längste Pfeil das 0.9-fache des Abstands (dieselbe Idee wie die automatische Skalierung in MATLAB, sodass er den Nachbarpfeil nicht überlappt). Der Skalierungsfaktor ändert sich von Abbildung zu Abbildung, daher bei nebeneinander verglichenen Abbildungen scale festlegen. Pfeile kürzer als 1 Pixel werden nicht gezeichnet (ein Punkt ohne Richtung würde als Markierung gelesen).

Args:

flow: (2, h, w) (dy, dx).

spacing: Abstand der Pfeile [Gitter]. None ergibt etwa 20 entlang der langen Seite.

scale: Pfeillänge = scale * Geschwindigkeit [Gitter].

upsample: Ausgabefaktor (groß genug, um Pfeilspitzen zu zeichnen).

background: (h*upsample, w*upsample) oder (…, 3). None bedeutet weiß.

Eine Farbtonkarte (vergrößertes piv_flow_to_rgbimage) oder LIC kann unterlegt werden.

color / width: Pfeilfarbe (Rollenname der palette oder RGB) und Schaftdicke [px].

Default ist eine fast schwarze Tintenfarbe (auch über einer Farbtonkarte lesbar).

Returns:

(h*upsample, w*upsample, 3) float64, Wertebereich [0, 1].

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 `rgb` als Eingabe)

—

Gleiche Kategorie (`visualise`)

piv_flow_to_rgbimage · piv_line_integral_convolution · piv_streamlines · piv_streamline_image

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

piv_quiver — PIV visualise op