select op• 資料種類:labels → labels
• 呼叫: import fullseye as fs; fs.ledger.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria)(要直接呼叫實作,import volcolor; volcolor.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria);從台帳取用則 opsvolcolor.get("vol_select_labels"))
• 經台帳呼叫的回傳值: fullseye.ledger.vol_select_labels(...) 只回傳宣告的 out 型別 labels 的值(底層函式還會回傳輔助資訊)。需要被捨棄的部分時,請用 fullseye.ledger.vol_select_labels.raw(...),或直接呼叫 volcolor.vol_select_labels。
按 3-D 特徵篩選成分(2-D 斑點篩選的 3-D 版)。
回傳 (labels_out, kept_ids)。被去掉的成分的體素變為 0(背景)。
*props* 是 vol_label_shape_stats 或 volops.vol_region_props 的回傳值。None 時當場呼叫 vol_label_shape_stats。
條件(全部可省略、給出的條件取 AND): min_volume max_volume min_voxels max_voxels min_sphericity max_sphericity min_elongation max_elongation min_isotropy max_isotropy min_equivalent_diameter max_equivalent_diameter。另外 exclude_border=True 會去掉接觸體資料邊緣的成分(把被 CT 視野截斷的顆粒排除在量測之外的標準步驟),keep=[...] 直接指定保留的 id。
props 中沒有所需的鍵則 ValueError。例如對 vol_label_shape_stats 的結果指定 min_sphericity 時,由於 sphericity 是那一方不輸出的量,所以拒絕 —— 若以預設值填補缺失的鍵,就會默默做出「寫了條件卻一件也沒去掉」的過濾器。
relabel:
• False(預設)—— 原樣保留原來的 id。因此即使在前後呼叫 vol_colorize_labels,留下的成分的顏色也不變。「過篩後顏色依然保留」的圖之所以成立,全靠這項預設。
• True —— 把留下的成分重新編號為 1..k。顏色會全部更換 (因為標籤編號就是調色盤的列號)。僅在下游要求連續編號時使用。這 1 個參數是唯一能破壞這一族賣點的地方,所以把它做成了顯式的。
回傳 (labels_out int32 (D, H, W), kept_ids np.ndarray int64)。對未知的條件、鍵不在 *props* 中的條件、未涵蓋實際存在標籤的 *props*,或包含體資料中不存在標籤的 *keep*,拋出 ValueError。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
labels 作為輸入)vol_colorize_labels · vol_label_overlay · vol_label_shape_stats · vol_label_legend · vol_labels_to_meshes · vol_label_volume_render
select)—
*Provenance: volcolor.py — VOLCOLOR 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.