evaluate op• Data kinds: points → table
• Call: import fullseye as fs; fs.ledger.plane_flatness_error(points, exclude_fraction=0.003) (to call the implementation directly, import acceptance3d; acceptance3d.plane_flatness_error(points, exclude_fraction=0.003); from the registry, opsacceptance.get("plane_flatness_error"))
• GPU: none (CPU reference implementation only)
Computes the flatness error F (range of signed distances from the least-squares plane) from the point cloud of a flat (table).
> The detailed description below is the original text — the summary and the headings are translated.
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 family guide
• 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.
• The canonical algorithm (author, year) and its uses are named in the family usage guide above.
• poc_3d_sensor_modalities — py -3.11 examples/poc_3d_sensor_modalities.py
table as input)acceptance_verdict · acceptance_scan · virtual_acceptance_test · acceptance_error_budget
evaluate)sphere_probing_error · sphere_spacing_error · acceptance_verdict
*Provenance: acceptance3d.py — ACCEPTANCE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.