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 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• (暂无)

类型可衔接的下一个算子(可接受 table 作为输入)

acceptance_verdict · acceptance_scan · virtual_acceptance_test · acceptance_error_budget

同类别(evaluate)

sphere_probing_error · sphere_spacing_error · acceptance_verdict


*Provenance: acceptance3d.py — ACCEPTANCE 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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