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.