medial op• 資料種類:voxel → voxel
• 呼叫: import fullseye as fs; fs.ledger.vol_distance_transform(vol_binary, spacing=None)(要直接呼叫實作,import volops; volops.vol_distance_transform(vol_binary, spacing=None);從台帳取用則 ops3d.get("vol_distance_transform"))
• GPU:有(許可清單中的機械式 GPU 路徑,CuPy)。device="auto" 在實測尺寸(16,777,216 像素)以上選擇 GPU
二值體的精確歐氏距離變換。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
Each foreground (non-zero) voxel is labelled with its Euclidean distance to the nearest background voxel, via scipy.ndimage.distance_transform_edt. Pass *spacing* (sz, sy, sx) (e.g. VolumeMeta.spacing_mm, or the VolumeMeta itself) to make the distance anisotropy-aware — millimetres rather than voxels; otherwise unit spacing is assumed. A non-{0, 1} input is thresholded at > 0.5.
Returns a (D, H, W) float64 distance field (0 on the background). Outside the volume is not background (a foreground slab touching the edge keeps growing towards it). With no background voxel at all the nearest background is infinitely far: every voxel is inf (the 2-D distance_transform returns its normalised maximum 1.0 in the same case). This op returns absolute distances, so the 2-D convention (normalise to 1.0) does not carry over; inf was chosen over raising so that a mixed batch keeps its shape. Dividing by the maximum afterwards gives NaN — check np.isinf first.
Reference: Felzenszwalb & Huttenlocher, Theory of Computing 2012.
Empty input (vol_binary with 0 elements) raises ValueError.
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• medial_topology — py -3.11 examples_3d/medial_topology.py
• molecule_atom_count — py -3.11 examples_3d/molecule_atom_count.py
• nearest_seed_partition — py -3.11 examples_3d/nearest_seed_partition.py
• vessel_metrology — py -3.11 examples_3d/vessel_metrology.py
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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.