vol_nearest_label — 3D medial op

• データ種: voxel → voxel

• 呼び出し: import fullseye as fs; fs.ledger.vol_nearest_label(vol_labels, spacing=None) (実装を直接呼ぶなら import volops; volops.vol_nearest_label(vol_labels, spacing=None)、台帳から引くなら ops3d.get("vol_nearest_label"))

使い方

零 voxel に最近の非零ラベルを配ったラベル体積 `(D, H, W)(ラベルのボロノイ分割、voxel`)。

入力は整数ラベル(`vol_label / vol_rle_components の出力、0 = 未割当)。各 0 voxel は物理距離(spacing`)で

最も近い非零 voxel のラベルを受け取り、非零 voxel はそのまま。EM の分割片や骨格の枝ラベルから「その枝が支配する

体積」を切り出す(枝ごとの体積・肉厚)のに使う。非整数のラベルは拒否(丸めて別のラベルにしない)、非零が 1 つも

無ければ ValueError。返りは int64。

>>> L = np.zeros((1, 1, 7)); L[0, 0, 0] = 1; L[0, 0, 6] = 2

>>> vol_nearest_label(L)[0, 0].tolist()

[1, 1, 1, 1, 2, 2, 2]

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

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

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

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

• nearest_seed_partition — py -3.11 examples_3d/nearest_seed_partition.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

同カテゴリ(medial)

distance_ridge · skeletonize_vol · medial_axis_points · topology_signature · medial_match · skeleton_junctions3d · skeleton_endpoints3d · skeleton_prune3d

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

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