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` を自分で書くこと。
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.