transform op• 資料種類:sdf → voxel
• 呼叫: import fullseye as fs; fs.ledger.sdf_to_occupancy(sdf, iso=0.0)(要直接呼叫實作,import match3d; match3d.sdf_to_occupancy(sdf, iso=0.0);從台帳取用則 ops3d.get("sdf_to_occupancy"))
SDF → occupancy voxel(小於等於 iso=內側=1)。從 SDF 回到 voxel。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
`(sdf <= iso).astype(float64) だけの op。signed_distance_field` の規約(内側 <0)なら
`iso=0.0 で内側=1、外側=0。**等号を含む**ので、ちょうど iso` の voxel は内側に入る。
`iso を正にすると外側へ iso` voxel ぶん膨らんだ占有、負にすると縮んだ占有になる
(SDF が真の距離なら等方 dilation/erosion と同じ)。`tsdf_from_depth` の出力(表面手前 +・
奥 −・未観測 +1)にも同じ `iso=0.0` で使えるが、未観測領域は 0 側(外)になる。
入力の形は問わず、返り値は同形の float64(0.0 / 1.0)。NaN は比較が偽なので 0 になる
(警告なし)。
★ラベル volume を渡すと背景が「内側」になる。`backends_typed.TYPE_TO_SORT` は
`sdf / labels / voxel を同じ volume` に畳むので、
`label_components や vol_label` の出力をそのまま繋いでも例外は出ない。
ラベルは 0 が背景・1 以上が前景なので `<= 0` は背景そのもの。実測
(2026-09-08、24³ の立方体、真の内側 1,728 voxel): SDF を渡すと 1,728、
同じ形の 0/1/2 ラベルを渡すと 9,504(5.5 倍)—— 符号が反転している。
ラベルから占有を作るなら `iso でなく labels > 0` を自分で書くこと。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• transforms_repr — py -3.11 examples_3d/transforms_repr.py
voxel 作為輸入)voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa
transform)points_to_voxel · gaussians_to_voxel · mesh_to_voxel · mesh_to_points · depth_to_points · voxel_to_mips · voxel_to_mesh · tsdf_from_depth
*Provenance: match3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.