smooth_flow — 3D scene_flow3d op

• Datenarten: points × points → flow_scattered

• Aufruf: import fullseye as fs; fs.ledger.smooth_flow(pts0, pts1, k: 'int' = 10, n_iter: 'int' = 5) -> 'np.ndarray' (die Implementierung direkt: import scene_flow3d; scene_flow3d.smooth_flow(pts0, pts1, k: 'int' = 10, n_iter: 'int' = 5) -> 'np.ndarray'; aus dem Register: ops3d.get("smooth_flow"))

Verwendung

Liefert einen regularisierten Fluss (N, 3): den Nächste-Nachbar-Fluss, lokal durch Nachbarschaftsmittelung geglättet.

Mittelt den Rohfluss von nearest_neighbor_flow (verrauscht, da aus der Korrespondenz über den nächsten Nachbarn) iterativ über die k-Nächste-Nachbarn-Topologie im Raum von pts0 (einschließlich des Punktes selbst, nur 1 Mal aufgebaut). Unterdrückt mittelwertfreies Rauschen und erhält glatte Verschiebungsfelder weitgehend (Jacobi-Iteration = Laplace-Glättung des Flussfeldes). Lineare Felder sind bei symmetrischer Nachbarschaft unverzerrt, Felder mit Krümmung schrumpfen leicht (ein ehrlicher Glättungs-Bias).

Args:

pts0: (N, 3)-Punktwolke zum Zeitpunkt 0.

pts1: (M, 3)-Punktwolke zum Zeitpunkt 1.

k: Anzahl der zur Mittelung verwendeten Nachbarn (einschließlich des Punktes selbst).

n_iter: Anzahl der Glättungsiterationen.

Returns:

(N, 3) geglättetes Verschiebungsvektorfeld.

Raises:

ValueError: ungültige Form, oder pts1 ist leer, während pts0 nicht leer ist.

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.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• scene_flow_rigid — py -3.11 examples_3d/scene_flow_rigid.py

Typkompatible Folge-Operatoren (nehmen flow_scattered als Eingabe)

fuse_to_voxel

Gleiche Kategorie (scene_flow3d)

nearest_neighbor_flow · rigid_flow


*Provenance: scene_flow3d.py — 3D 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.