vol_label — 3D regionprops op

データ種: voxellabels

呼び出し: import fullseye as fs; fs.ledger.vol_label(vol_binary, connectivity=26) (実装を直接呼ぶなら import volops; volops.vol_label(vol_binary, connectivity=26)、台帳から引くなら ops3d.get("vol_label"))

台帳経由の戻り値: fullseye.ledger.vol_label(...) は**宣言 out 型 labels の値だけ**を返す(本体は補助情報も返す)。捨てられた側が要るときは fullseye.ledger.vol_label.raw(...)、または volops.vol_label を直接呼ぶ。

• 本体の返り: (labels, n)

使い方

近傍を選べる 3-D 連結成分ラベリング。

> 以下の詳細説明は原文のままです —— 要約と見出しは訳出済み。

*connectivity* chooses the structuring element: `6` (face neighbours only),

`18 (faces + edges), or 26` (faces + edges + corners — the default,

`ndimage.generate_binary_structure(3, 3)). A non-{0, 1}` input is

thresholded at `> 0.5`.

Returns `(labels, n) — an int32 volume whose voxels are 0`

(background) or a component id in `1..n, and the component count n`.

The neighbourhood genuinely matters: two blobs meeting only at a corner are

*two* components under 6-connectivity but *one* under 26.

背景知識ガイド(この op の手前にある物理・規約)

measurement_uncertainty — 計測の不確かさと校正の知識 — 「測れている」を主張するために

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

ct_bone_segmentationpy -3.11 examples_3d/ct_bone_segmentation.py

molecule_atom_countpy -3.11 examples_3d/molecule_atom_count.py

vessel_metrologypy -3.11 examples_3d/vessel_metrology.py

型が繋がる次の op(labels を入力に取れる)

fuse_to_voxel · vol_region_props

同カテゴリ(regionprops)

label_components · region_props · largest_component · filter_by_volume · inner_box3 · vol_region_props


*Provenance: volops.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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