add_metrology_object_line_measure — MEASURE1D model op

• 資料種類:metrologymodel → scalar

• 呼叫: import fullseye as fs; fs.ledger.add_metrology_object_line_measure(model, row1, col1, row2, col2, n: 'int' = 25) -> 'int'(要直接呼叫實作,import metrology; metrology.add_metrology_object_line_measure(model, row1, col1, row2, col2, n: 'int' = 25) -> 'int';從台帳取用則 opsmeasure1d.get("add_metrology_object_line_measure"))

用法

新增直線量測物件(add_metrology_object_line_measure)。回傳 index。

把參考線段 (row1, col1) → (row2, col2) [px] 堆疊到 model["objects"] (原地更新 dict)。apply_metrology_model 在此線段上等間隔(含兩端)放置 n 個點,從各點沿線段的法線方向拉出短量測線,尋找次像素邊緣,再對所得點用最小平方重新擬合直線。

• n: 取樣點數(預設 25)。越多擬合越穩定,但量測時間成正比增加。

• 端點重合(長度 < 1e-9)的線段可以堆疊,但 apply 時取樣為 0 個 → 視為擬合失敗,以 params=None、rms=inf 回傳(不會成為例外)。

• 參數的型別、範圍在此不做驗證(影像外的座標也能堆疊;apply 時只會用最近鄰外插,不會拋出例外)。

• 回傳值: 所新增物件的 index(從 0 開始)。apply 結果 list 的同一位置是 type="line" 的結果(row1/col1/row2/col2/angle_deg)。

用 align_metrology_model 平移時,兩端點一起移動。

詳細使用指南

• 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_circle_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.