flow_apply — REPRCONV flow op

• Datenarten: points × flow_scattered → points

• Aufruf: import fullseye as fs; fs.ledger.flow_apply(points, flow) (die Implementierung direkt: import reprconv; reprconv.flow_apply(points, flow); aus dem Register: opsreprconv.get("flow_apply"))

Verwendung

Addiert einen verstreuten Fluss (N,3) zu einer Punktmenge (N,3) → points. Die verbrauchende Seite von flow.

Da estimate_flow(a, b) "die Verschiebung von jedem Punkt von a zu seinem nächsten Nachbarn in b" liefert, bewegt flow_apply(a, estimate_flow(a, b)) auf diejenigen Punkte von b, die von a aus als nächste Nachbarn gewählt wurden. Der Hin- und Rückweg ist nur exakt, wenn die Zuordnung bijektiv ist; andernfalls schrumpft die Form genau um das Maß, in dem "2 Punkte von a auf denselben Punkt von b fallen" -- selftest gibt dieses Residuum als Zahl aus.

Args:

points: (N, 3).

flow: (N, 3).

Returns:

(N, 3) float64.

Raises:

ValueError: Zeilenzahl stimmt nicht / ungültige Form / nicht endlich.

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 points als Eingabe)

points_zyx_to_keypoints_uv · points_to_position · select_points · points_to_gaussians

Gleiche Kategorie (flow)

flow_magnitude · flow_to_rgbimage · flow_speed


*Provenance: reprconv.py — REPRCONV 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.