add_metrology_object_circle_measure — MEASURE1D `model` op

• 数据种类:metrologymodel → scalar

• 调用: import fullseye as fs; fs.ledger.add_metrology_object_circle_measure(model, row, col, radius, n: 'int' = 40) -> 'int'(要直接调用实现,import metrology; metrology.add_metrology_object_circle_measure(model, row, col, radius, n: 'int' = 40) -> 'int';从台账取用则 opsmeasure1d.get("add_metrology_object_circle_measure"))

用法

添加圆计量对象(add_metrology_object_circle_measure)。

把参考圆(中心 (row, col)、半径 radius [px])堆叠到 model["objects"] (原地更新 dict)。apply_metrology_model 在把圆周 n 等分的角度上放置点，在各点沿半径方向(外法线)拉出测量线，取得亚像素边缘，用最小二乘圆拟合重新求出中心和半径。

• radius: 参考半径 [px]。与实物的偏差必须落在 apply 的 measure_length (默认 ±6 px)以内 —— 超出范围的边缘找不到。

• n: 圆周上的采样数(默认 40)。半径越大的圆越应增加。

• 参数在此不做校验(0 以下的半径也能堆叠，但没有意义)。

• 返回值: 添加位置的 index(从 0 开始)。apply 结果的 params 为 row / col / radius,rms 为距圆的径向残差 [px]。

用于孔径、销径的检查以及圆形零件的定心。

n 的参考值(2026-09-15 实测,模糊 σ=1 px 的合成圆盘):偏差与 n 无关(R=8〜128 px、n=6〜240 时恒定在 ±0.005 px 以内。偏差本身因边缘圆化随 R 变化,−0.09 → −0.006 px)。n 影响的是离散:噪声 σ=0.03 时,只要圆周上的采样间隔 2πR/n 约 3 px 以上,std·√n 就保持恒定(= 样本独立,std ∝ 1/√n),再加密也不再下降(R=16:n=40 时 0.0174,n=240 时 0.0164 px)。因此超过 n ≈ 2πR / 3(R=20 时 40 = 默认值,R=64 时 130,R=128 时 270)只会增加时间(n=1000 时 22 ms)。圆周缺 25 % 时增大 n 也修不好偏差(−0.005 → −0.020 px)。若只是缺口一侧找不到边缘,rms 反而下降(0.051 → 0.018);若在缺口边界拾取了假边缘,rms 会跳升 —— 缺口仅凭 rms 看不出,所以也要把 edge_points 的个数作为门(examples/example_inner_diameter_mm.py)。参考半径的偏差以 measure_length(默认 ±6 px)为上限,+5.5 px 可通过,+6.5 px 时 params=None。

空输入(model 为空 dict)会引发 ValueError。

详细使用指南

• subpixel_measuring 族使用指南

参考(示例数据、文献)

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

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

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

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

• example_inner_diameter_mm — py -3.11 examples/example_inner_diameter_mm.py

• poc_calipers_under_illusion — py -3.11 examples/poc_calipers_under_illusion.py

• poc_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.py

• poc_telecentric_metrology — py -3.11 examples/poc_telecentric_metrology.py

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

—

同类别(`model`)

create_metrology_model · add_metrology_object_line_measure · add_metrology_object_rectangle2_measure · add_metrology_object_ellipse_measure · add_metrology_object_generic

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

add_metrology_object_circle_measure — MEASURE1D model op

用法