acceptance_scan — ACCEPTANCE simulate op

• 数据种类:table × table → points

• 调用: import fullseye as fs; fs.ledger.acceptance_scan(sensor, artifact, seed=0)(要直接调用实现,import acceptance3d; acceptance3d.acceptance_scan(sensor, artifact, seed=0);从台账取用则 opsacceptance.get("acceptance_scan"))

• GPU:无(仅 CPU 参考实现)

用法

用仿真传感器拍摄一个试验件并返回其点云 (N, 3)(points)。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

Scan one artefact (probe sphere, ball bar or plane from acceptance_layout) with a simulated sensor and return its points (N, 3) in the sensor frame, mm. For a ball bar the points of both spheres are concatenated in the order a, b (use virtual_acceptance_test for the split).

センサ(sensor の kind):

• "ideal" —— 真の視線距離をそのまま返す(雑音なし)。往復の検算用。

• "triangulation" —— 奥行き z に正規雑音 σ_z = z²·σ_d / (f·b)(z = f·b/d の誤差伝播、disparity_sigma_px = σ_d、baseline_mm = b)。構造化光・ステレオの雑音則の代表で、縞を描いて復号するわけではない(限界)。

• "itof" —— 既存の itof.itof_capture → itof.itof_phase_amplitude で 4 位相の生信号から距離を出す(ショット雑音・反射率・背景光・supersample による縁の混合 = フライングピクセル・ multipath_amplitude の 2 経路の多重反射)。多重反射は「全画素に一様な第 2 経路(余分な経路長 multipath_extra_mm)」の最も粗いモデル。

校正の誤差は逆投影に入る: fx_rel_error・fy_rel_error(相対)、cx_error_px・cy_error_px、距離の尺度 range_scale とオフセット range_offset_mm。真値は場面の解析解(光線と球・平面の交点)。

Raises ValueError: センサの表に kind が無い(空の表は既定値で黙って走らせない)・鍵が未知・値が範囲外、試験体が配置の形でない、点が 10 点未満しか写らない。

详细使用指南

• optical_3d_acceptance 族使用指南

参考(示例数据、文献)

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

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

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

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

• poc_virtual_acceptance_3d — py -3.11 examples/poc_virtual_acceptance_3d.py

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

sphere_probing_error · sphere_spacing_error · plane_flatness_error

同类别(simulate)

virtual_acceptance_test


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

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