sdf_csg op• 데이터 종류: coordgrid → sdf
• 호출: import fullseye as fs; fs.ledger.plane_sdf(grid, point, normal)(구현을 직접 호출하려면 import sdf_ops; sdf_ops.plane_sdf(grid, point, normal), 원장에서 가져오려면 ops3d.get("plane_sdf"))
> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.
半空間(平面で切った側)の厳密な符号付き距離場(内側負・外側正)。
`sdf(p) = (p - point) · n̂。法線 n̂` の指す側が外側(正)で、反対側が内側。
面取り(chamfer)・切断・「基板から上だけ」のような片側だけを残す演算に使う。
`sdf_intersect` を重ねれば任意の凸多面体が作れる。ただし **max による交差は角の外側で
厳密ではない**: 6 枚で直方体を作ると占有(`<= 0)と内側の値は box_sdf` に完全一致
するが、外側は角の近くで最大 2.1(半辺 2 の箱・格子 0.25 で実測)だけ過小評価する
—— CSG の標準的な性質で、距離そのものが要るなら `box_sdf` を使う。
厳密性: 平面は全空間で勾配ノルム 1 なので、この値はどこでも真の符号付き距離
(`box_sdf` のように角で切り替わる場合分けが要らない)。
引数と検証(`ValueError`):
• `grid: 最終軸が 3 の float 配列 (..., 3)(grid_coords` の出力または点列)。
• `point`: 平面上の 1 点(要素数 3)。
• `normal`: 平面の法線(要素数 3、零ベクトル・NaN は拒否)。長さは自動で 1 に
正規化するので、大きさは結果に影響しない(向きだけが意味を持つ)。
返り値: `grid.shape[:-1]` の float64。法線側で正、反対側で負、平面上で 0。
使いどころ: `sdf_subtract(part, plane_sdf(g, p, n))` で「その平面より法線側を削る」。
向きを逆にしたいときは `normal の符号を反転する(-sdf` でも同じ)。
• 샘플 데이터 카탈로그(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 · cylinder_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.