nearest_neighbor_flow — 3D scene_flow3d op

• Datenarten: points × points → flow_scattered

• Aufruf: import fullseye as fs; fs.ledger.nearest_neighbor_flow(pts0, pts1) -> 'np.ndarray' (die Implementierung direkt: import scene_flow3d; scene_flow3d.nearest_neighbor_flow(pts0, pts1) -> 'np.ndarray'; aus dem Register: ops3d.get("nearest_neighbor_flow"))

Verwendung

Das 3-D-Verschiebungsvektorfeld (N, 3) von jedem Punkt in pts0 zu seinem nächsten Nachbarn in pts1.

Bestimmt für jeden Punkt p von pts0 den nächsten Nachbarn q in pts1 mit cKDTree und gibt die Verschiebung q - p zurück. Die Elementanzahlen dürfen verschieden sein, N != M. Nur wenn die Verschiebung deutlich kleiner als der lokale Punktabstand ist (kleine Bewegung), trifft es "die wahre Korrespondenz von Punkt i" — bei großen Verschiebungen haftet der nächste Nachbar an einem anderen Punkt (eine ehrliche Grenze; zur Regularisierung mit smooth_flow kombinieren).

Args:

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

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

Returns:

(N, 3)-Verschiebungsvektorfeld (gleiche Zeilenreihenfolge wie pts0).

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)

rigid_flow · smooth_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.