estimate_flow — 3D `motion_segment` op

• Data kinds: points × points → flow_scattered

• Call: import fullseye as fs; fs.ledger.estimate_flow(pts0, pts1) -> 'np.ndarray' (to call the implementation directly, import motion_seg3d; motion_seg3d.estimate_flow(pts0, pts1) -> 'np.ndarray'; from the registry, ops3d.get("estimate_flow"))

Usage

The 3-D displacement vector field (N, 3) from each point of pts0 to its nearest neighbour in pts1 (nearest-neighbour flow).

> The detailed description below is the original text — the summary and the headings are translated.

`pts0 の各点 p について pts1 中の最近傍 q を cKDTree で求め、変位 q - p`

を返す。要素数は N != M でよい。変位が局所点間隔より十分小さい小運動でのみ「点 i の

真の対応先」を当てる(honest な最近傍の限界)。segment_rigid_motions が inlier 判定に

使う 観測フロー を与える。

Args:

pts0: (N, 3) 時刻 0 の点群。

pts1: (M, 3) 時刻 1 の点群。

Returns:

(N, 3) 変位ベクトル場(pts0 と同じ行順)。空 pts0 は (0, 3) を返す。

Raises:

ValueError: 形状不正、または pts0 が非空なのに pts1 が空(最近傍が存在しない)。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

Runnable examples (verified samples that actually call this op)

• motion_scene — py -3.11 examples_3d/motion_scene.py

Ops the type connects to (they accept `flow_scattered` as input)

fuse_to_voxel

Same category (`motion_segment`)

segment_rigid_motions · fit_rigid

*Provenance: motion_seg3d.py — 3D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

estimate_flow — 3D motion_segment op