flow_to_rgbimage — REPRCONV `flow` op

• Datenarten: flow_dense → rgbimage

• Aufruf: import fullseye as fs; fs.ledger.flow_to_rgbimage(flow, index=None, scale=None) (die Implementierung direkt: import reprconv; reprconv.flow_to_rgbimage(flow, index=None, scale=None); aus dem Register: opsreprconv.get("flow_to_rgbimage"))

Verwendung

Eine Schicht eines dichten Szenenflusses → ein rgbimage mit Farbton = Richtung und Hellwert = Geschwindigkeit.

Wendet die Standardvisualisierung des optischen Flusses (Farbkreis) auf eine z-Scheibe eines 3-D-Flusses an:

hue = atan2(dy, dx) (in Grad, 0-360), value = |(dy, dx)| / scale, Sättigung 1. dz wird verworfen -- das macht explizit, dass die Abbildung nur die Komponenten in der Ebene zeigt (mischte man die verworfene Komponente in die Farbe, könnte niemand mehr sagen, "welche Größe die sichtbare Farbe ist").

Einseitig. Die Farbkreis-Legende unbedingt mit in die Abbildung einbrennen (eine Flussabbildung, auf der die Bedeutung der Farben nicht steht, ist nur hübsch und nicht lesbar).

Args:

flow: (3, D, H, W).

index: zu entnehmende z-Scheibe (Standard = Mitte).

scale: Geschwindigkeit in der Ebene, die Helligkeit 1.0 entspricht (Standard = Maximum dieser Scheibe.

Bei 0 wird ein vollständig schwarzes Bild zurückgegeben).

Returns:

(H, W, 3) float64, Wertebereich [0, 1].

Raises:

ValueError: kein dichter Fluss / index außerhalb des Bereichs / scale <= 0.

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)

• representation_conversion — py -3.11 examples/representation_conversion.py

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

—

Gleiche Kategorie (`flow`)

flow_magnitude · flow_speed · flow_apply

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

flow_to_rgbimage — REPRCONV flow op