sdf_csg op• 데이터 종류: coordgrid → sdf
• 호출: import fullseye as fs; fs.ledger.cylinder_sdf(grid, center, axis, radius, height)(구현을 직접 호출하려면 import sdf_ops; sdf_ops.cylinder_sdf(grid, center, axis, radius, height), 원장에서 가져오려면 ops3d.get("cylinder_sdf"))
유한 길이 원기둥(양 끝이 평평한 뚜껑)의 엄밀한 부호 거리장(안쪽 음, 바깥쪽 양).
축 방향 거리 t 와 축으로부터의 반지름 r 로 나누어 q = (r - radius, |t| - height/2) 로 두고 outside = ‖max(q, 0)‖, inside = min(max(q), 0), sdf = outside + inside. 이것은 box_sdf 와 같은 Quilez 식 구성을 "(반지름, 축)의 2-D 단면"에 적용한 것으로, 측면, 뚜껑, 모서리(테두리) 어느 것에 대해서도 참인 유클리드 거리가 된다.
인수와 검증(ValueError):
• grid: 마지막 축이 3 인 float 배열 (..., 3).
• center: 원기둥의 중심(끝면이 아니라 무게중심. 요소 수 3).
• axis: 축 방향(요소 수 3, 영벡터와 NaN 은 거부. 길이는 자동 정규화).
• radius: 반지름 > 0 에 해당하는 스칼라(0 은 축선 자체, 음수는 거부).
• height: 전체 길이 스칼라(center 에서 ±height/2. 음수는 거부).
반환값: grid.shape[:-1] 의 float64.
사용처: 관통 구멍은 sdf_subtract(part, cylinder_sdf(...))(height 를 부품보다길게 하여 끝면의 테두리를 남기지 않는다). 보스, 핀, 샤프트는 sdf_union. 무한 길이의 원기둥이필요하면 height 를 충분히 크게 잡는다(끝면이 평가 영역 밖으로 나가면 측면만 작용한다).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• sdf_csg — py -3.11 examples_3d/sdf_csg.py
sdf 를 입력으로 받는 것)sdf_to_occupancy · fuse_to_voxel · integrate · extract_surface_points · query_distance · sdf_union · sdf_intersect · sdf_subtract
sdf_csg)grid_coords · sphere_sdf · box_sdf · plane_sdf · torus_sdf · capsule_sdf · sdf_union · sdf_intersect
*Provenance: sdf_ops.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.