deviation op• 데이터 종류: points × points → signal
• 호출: import fullseye as fs; fs.ledger.signed_surface_distance(query, surface, surface_normals=None, k: 'int' = 1)(구현을 직접 호출하려면 import shapestats; shapestats.signed_surface_distance(query, surface, surface_normals=None, k: 'int' = 1), 원장에서 가져오려면 opsshapestat.get("signed_surface_distance"))
질의점에서 면까지의 부호 있는 거리. → (N,).
부호는 면의 법선으로 정한다(바깥쪽이 양). 1-D 윤곽에는 profileops.profile_deviation 이 있는데 3-D 에는 상응하는 것이 없었다, 라는 것이 2026-09-06 에 PoC 가 드러낸 구멍.
법선을 생략하면 normals_orient.estimate_oriented_normals 로 추정한다 —— 방향이 붙어 있지 않으면 부호가 점마다 흩어진다(그냥 PCA 법선은 부호가 임의이며, 회전하면 4 할이 뒤집힌다. pointcloud.fpfh 가 밟은 것과 같은 구멍).
k 는 부호를 정할 때 쓰는 최근접의 수. 1 이면 최근접 1 점의 법선에 거는것이 되어, 잡음이 있는 면에서는 부호가 튄다. 2 이상으로 하면 거리로 가중치를 준평균 방향으로 정한다(거리 자체는 최근접 그대로).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• poc_am_thermal_to_ct — py -3.11 examples/poc_am_thermal_to_ct.py
• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py
signal 를 입력으로 받는 것)deviation)—
*Provenance: shapestats.py — SHAPESTAT 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.