blob_region — BLOB extract op

• 資料種類:labels2d → mask

• 呼叫: import fullseye as fs; fs.ledger.blob_region(labels: 'Any', index: 'int') -> 'np.ndarray'(要直接呼叫實作,import blob2d; blob2d.blob_region(labels: 'Any', index: 'int') -> 'np.ndarray';從台帳取用則 opsblob.get("blob_region"))

用法

將 1 個物體擷取為二值區域(bool)。index 從 1 起算。

只回傳 labels == index 的選擇 op。編號是 blob_label 賦予的 1..n 連續編號,0 是背景。

• labels:2-D 整數標籤影像(blob_label / blob_select / blob_split 的輸出)。拒絕 bool 遮罩(為防止「把多個物體當作 1 個來量」的事故,提示先套用 blob_label)。float 也拒絕(無法確定 0.999 是哪個物體)。若有負編號則 ValueError。

• index:滿足 1 <= index <= labels.max() 的 int。0(背景)或超出範圍則 ValueError。與 blob_features 的 label 欄、blob_select_largest 的結果(從 1 重新編號)使用同一編號體系。

• 回傳值:(H, W) 的 bool。不會為空(編號必定存在 —— 但若自製標籤未經 blob_select 重新編號而有缺號, 可能回傳全 False)。

取出的區域可以直接傳給 blob_distance(距離轉換)、blob_overlay 的疊加繪製、annotate_outline 的輪廓繪製。

詳細使用指南

• blob_analysis 族使用指南

參考(範例資料、文獻)

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

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

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

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

• poc_gear_tooth_metrology — py -3.11 examples/poc_gear_tooth_metrology.py

• poc_particle_sizing — py -3.11 examples/poc_particle_sizing.py

型別可銜接的下一個運算子(可接受 mask 作為輸入)

blob_label · blob_distance

同類別(extract)

blob_boundaries · blob_overlay


*Provenance: blob2d.py — BLOB 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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