transform op• 資料種類:voxel → sdf
• 呼叫: import fullseye as fs; fs.ledger.signed_distance_field(vol, device='cpu', iso=0.5)(要直接呼叫實作,import match3d; match3d.signed_distance_field(vol, device='cpu', iso=0.5);從台帳取用則 ops3d.get("signed_distance_field"))
• GPU:該運算子有 GPU 路徑(device="cuda")
occupancy/密度 voxel → 符號距離場 SDF(內側<0・外側>0)。對兩側各做 edt_jfa。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
SDF はマッチングに優れた表現(滑らか・勾配=法線・0 等値面=表面)。inside/outside の
ユークリッド距離差で作る。GPU native。voxel↔SDF↔occupancy を相互変換できる。
定義: `occ = vol > iso として d_out = edt_jfa(occ)`(各 voxel から最寄りの占有 voxel
までの距離、占有内では 0)、`d_in = edt_jfa(~occ)`(最寄りの非占有 voxel まで)、
`sdf = d_out − d_in`。外側は +距離、内側は −距離(voxel 単位、ユークリッド)。
voxel 中心同士の距離なので 0 になる voxel は無く、境界の占有 voxel は −1、隣接する
非占有 voxel は +1(0 等値面は voxel の間)。
`iso` は密度→占有の閾値(既定 0.5。個数密度なら「1 点以上」)。全占有・全空の volume は
seed の無い側の距離が 1e6 に飽和し、全占有では −1e6、全空では +1e6 になる(例外は出ない)。
返り値 `(D,H,W)` float32 numpy。
後段: `sdf_to_occupancy で戻す、voxel_to_mesh(sdf, iso=0.0) で面、sobel3d` で法線場。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• transforms_repr — py -3.11 examples_3d/transforms_repr.py
sdf 作為輸入)sdf_to_occupancy · fuse_to_voxel · integrate · extract_surface_points · query_distance · sdf_union · sdf_intersect · sdf_subtract
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.