plane_flatness_error — ACCEPTANCE evaluate op

• 데이터 종류: points → table

• 호출: import fullseye as fs; fs.ledger.plane_flatness_error(points, exclude_fraction=0.003)(구현을 직접 호출하려면 import acceptance3d; acceptance3d.plane_flatness_error(points, exclude_fraction=0.003), 원장에서 가져오려면 opsacceptance.get("plane_flatness_error"))

• GPU: 없음(CPU 참조 구현만)

사용법

평면의 점군으로부터 평면도 오차 F(최소제곱 평면으로부터의 부호 있는 거리의 범위)를 계산한다(table).

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Flatness measurement error F: range of signed distances from the least-squares (orthogonal- regression) plane, after dropping at most floor(exclude_fraction*N) largest deviations and refitting once. Definition as described in Carfagni et al. 2019 for VDI/VDE 2634 Part 2.

★最小二乗の平面(Gauss)であり、最小領域(Chebyshev)の平面ではない。最小領域の F は最小二乗の F 以下になる(定義から)。正弦のうねり(振幅 A、周期の整数倍)を持つ平面では最小二乗の平面が公称の平面と一致し、F = 2A。

返す dict: f、normal (3,)、center (3,)、residual_rms、n_points、n_used、n_excluded。

Raises ValueError: 点が (N, 3) でない・10 点未満・非有限、共線(法線が定まらない)、exclude_fraction が [0, 0.05] の外。

자세한 사용 가이드

• optical_3d_acceptance 패밀리 가이드

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

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

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

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

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

• poc_3d_sensor_modalities — py -3.11 examples/poc_3d_sensor_modalities.py

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

acceptance_verdict · acceptance_scan · virtual_acceptance_test · acceptance_error_budget

같은 카테고리(evaluate)

sphere_probing_error · sphere_spacing_error · acceptance_verdict


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

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