transform op• 데이터 종류: voxel → mesh
• 호출: import fullseye as fs; fs.ledger.voxel_to_mesh(vol, iso=0.5)(구현을 직접 호출하려면 import match3d; match3d.voxel_to_mesh(vol, iso=0.5), 원장에서 가져오려면 ops3d.get("voxel_to_mesh"))
• 원장 경유의 반환값: fullseye.ledger.voxel_to_mesh(...) 는 선언된 out 형 mesh 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.voxel_to_mesh.raw(...) 를 쓰거나 match3d.voxel_to_mesh 를 직접 호출하세요.
voxel → mesh(marching cubes, skimage). 반환값 (verts, faces, normals). voxel→mesh 변환.
skimage.measure.marching_cubes(vol, level=iso)의 얇은 래퍼(spacing 지정 없음 = 1 voxel 단위). verts (V,3) float는 voxel index 좌표이며, 열은 입력의 축 순서(vol이 (D,H,W) 라면 (z,y,x)). faces (F,3) int는 verts에 대한 index, normals (V,3)는 skimage가기울기로부터 주는 정점 법선. 4번째 반환값(values)은 버린다.
• iso: 등값면의 레벨. 입력 값 범위 밖이면 skimage가 ValueError를 낸다(전부 0인
volume에서 iso=0.5 등). 개수 밀도라면 0.5, SDF라면 0.0을 넘긴다.
• 경계에 닿는 등값면은 열린 채로 남는다(끝에서 닫히지 않는다).
• ★감기 순서는 안쪽 방향. 그대로 mesh_volume에 넘기면 보통의 속이 찬 형태라도음수가 된다(실측: 1000 voxel의 정육면체에서 -985.67). 부피만 필요하면
abs(), 방향을 맞추고 싶다면 faces[:, ::-1]로 다시 감는다.
• skimage는 호출 시 import(미설치라면 ImportError).
후단: mesh_to_points로 점군화, mesh_area / face_areas / mesh_volume / boundary_vertices / mesh_edge_stats로 계측.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• mesh_smooth — py -3.11 examples_3d/mesh_smooth.py
mesh 를 입력으로 받는 것)mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty
transform)points_to_voxel · gaussians_to_voxel · mesh_to_voxel · mesh_to_points · depth_to_points · voxel_to_mips · tsdf_from_depth · signed_distance_field
*Provenance: match3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.