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.