curvilinear op• 데이터 종류: voxel → voxel
• 호출: import fullseye as fs; fs.ledger.cylinder_unwrap(vol, center=None, r_in=0.0, r_out=None, ntheta=180, nr=32, device='cpu')(구현을 직접 호출하려면 import match3d; match3d.cylinder_unwrap(vol, center=None, r_in=0.0, r_out=None, ntheta=180, nr=32, device='cpu'), 원장에서 가져오려면 ops3d.get("cylinder_unwrap"))
• GPU: 있음(허용 목록의 기계적 GPU 경로, CuPy). device="auto" 는 측정한 크기(16,777,216 픽셀) 이상에서 GPU를 선택
voxel 의 원통면을 (height×θ×r) 로 펼칩니다(원통 부품/배관의 내외면 검사). 축 = z(D 축).
θ 축은 endpoint 없는 주기 그리드 (polar_unwrap 와 같은 2026-08-30 수정).
Raises ValueError : 입력에 NaN / Inf / float32 자리 넘치는 경우.
인수 : "vol"은 "(D, H, W)", "center = (cy, cx)"는 각 z 슬라이스의 (행, 열) (기본값은
슬라이스 중심). "r_in"~ "r_out"(voxel, 기본값 "min (H, W) / 2-1")을 "nr"등분, 각도 ntheta 등분. 출력(D, ntheta, nr) ''float32 : 축 0은 z (높이, 입력과 동일), 행 k의 각도 "θ = k · 2π / ntheta", 열 j의 반경. 샘플 점은 (z, cy + r sinθ, cx + r cosθ), volume 밖은 0. D, H, W가 1 인 축도 픽셀 좌표로 보간되며 0 나눗셈은 발생하지 않습니다.
후단 : "[:, :, j]"를 취하면 반경 j의 원통면이 (D × θ)의 2-D 이미지가되어 2-D의 상처 검사
ncc_locate를 사용할 수 있습니다.
빈 입력 (vol이 0 요소)은 ValueError입니다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• curvilinear_proj — py -3.11 examples_3d/curvilinear_proj.py
voxel 를 입력으로 받는 것)voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa
curvilinear)*Provenance: match3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.