acceptance_scan — ACCEPTANCE `simulate` op

• Data kinds: table × table → points

• Call: import fullseye as fs; fs.ledger.acceptance_scan(sensor, artifact, seed=0) (implementation को सीधे call करना हो तो import acceptance3d; acceptance3d.acceptance_scan(sensor, artifact, seed=0), registry से लेना हो तो opsacceptance.get("acceptance_scan"))

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

एक simulated sensor से एक test artefact को scan करके उसका point cloud (N, 3) लौटाता है (points)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

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 点未満しか写らない。

उपयोग की विस्तृत guide

• optical_3d_acceptance family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_virtual_acceptance_3d — py -3.11 examples/poc_virtual_acceptance_3d.py

वे अगले ops जिनसे type जुड़ता है (`points` को input के रूप में लेते हैं)

sphere_probing_error · sphere_spacing_error · plane_flatness_error

इसी category के (`simulate`)

virtual_acceptance_test

*Provenance: acceptance3d.py — ACCEPTANCE operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

acceptance_scan — ACCEPTANCE simulate op