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]。

用於孔徑、銷徑的檢查以及圓形零件的定心。

詳細使用指南

• subpixel_measuring 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

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

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_calipers_under_illusion — py -3.11 examples/poc_calipers_under_illusion.py

• poc_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.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 自動產生(請勿手動編輯)。*

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