smooth_flow — 3D scene_flow3d op

• 데이터 종류: points × points → flow_scattered

• 호출: import fullseye as fs; fs.ledger.smooth_flow(pts0, pts1, k: 'int' = 10, n_iter: 'int' = 5) -> 'np.ndarray'(구현을 직접 호출하려면 import scene_flow3d; scene_flow3d.smooth_flow(pts0, pts1, k: 'int' = 10, n_iter: 'int' = 5) -> 'np.ndarray', 원장에서 가져오려면 ops3d.get("smooth_flow"))

사용법

최근접 플로를 이웃 평균으로 국소 평활한 정칙화 플로 (N, 3) 를 돌려줍니다.

nearest_neighbor_flow 의 생 플로(최근접 대응이므로 잡음이 실린다)를, pts0 공간의 k 근방 토폴로지(자신 포함, 1 번만 구축)로 반복 평균한다. 영평균 잡음을 억제하면서 매끄러운 변위장은 대체로 보존한다(Jacobi 반복 = 플로 장의 라플라시안 평활화). 선형 장은 대칭 근방에서 불편, 곡률이 있는 장은약간 줄어든다(honest 한 평활화 바이어스).

Args:

pts0: (N, 3) 시각 0 의 점군.

pts1: (M, 3) 시각 1 의 점군.

k: 평균에 쓰는 근방 수(자신 포함).

n_iter: 평활화 반복 횟수.

Returns:

(N, 3) 평활화된 변위 벡터장.

Raises:

ValueError: 형상 부정, 또는 pts0 이 비어 있지 않은데 pts1 이 비어 있음.

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• scene_flow_rigid — py -3.11 examples_3d/scene_flow_rigid.py

타입이 이어지는 다음 연산자(flow_scattered 를 입력으로 받는 것)

fuse_to_voxel

같은 카테고리(scene_flow3d)

nearest_neighbor_flow · rigid_flow


*Provenance: scene_flow3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.