sphere_spacing_error — ACCEPTANCE evaluate op

• Data kinds: points × points → table

• Call: import fullseye as fs; fs.ledger.sphere_spacing_error(points_a, points_b, calibrated_distance, exclude_fraction=0.003, fixed_diameter=None) (to call the implementation directly, import acceptance3d; acceptance3d.sphere_spacing_error(points_a, points_b, calibrated_distance, exclude_fraction=0.003, fixed_diameter=None); from the registry, opsacceptance.get("sphere_spacing_error"))

• GPU: none (CPU reference implementation only)

Usage

Computes the sphere-spacing error SD from the point clouds of a ball bar (two spheres) (table).

> The detailed description below is the original text — the summary and the headings are translated.

Sphere-spacing error SD of a ball bar: distance of the two fitted sphere centres minus the calibrated distance (signed: positive when measured too long).

各球は sphere_probing_error と同じ当てはめ(半径自由、最大偏差の点を除いて当て直し)。fixed_diameter を与えると半径をその値に固定して中心だけを当てる(文献によっては固定半径で評価する; 既定は自由)。定義は Carfagni et al. 2019 / Eiríksson et al. 2016 の記述による。規格本文の写しではない。Each sphere is fitted as in sphere_probing_error; fixed_diameter fixes the radius.

返す dict: sd、distance、calibrated_distance、center_a、center_b、diameter_a、diameter_b、pf_a、pf_b、n_used_a、n_used_b。

限界: 尺度の誤差は SD に (s−1)·L で出る(L が長いほど見える)ので、L は測定体積の対角に近いほどよい。

Raises ValueError: どちらかの点群が不正(sphere_probing_error と同じ条件)、calibrated_distance が正でない、fixed_diameter が正でない、2 つの中心が重なる。

Detailed usage guide

• optical_3d_acceptance family guide

References (sample data, literature)

• 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.

Runnable examples (verified samples that actually call this op)

• poc_3d_sensor_modalities — py -3.11 examples/poc_3d_sensor_modalities.py

Ops the type connects to (they accept table as input)

acceptance_verdict · acceptance_scan · virtual_acceptance_test · acceptance_error_budget

Same category (evaluate)

sphere_probing_error · plane_flatness_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.