geometry op• 데이터 종류: points → primitive
• 호출: import fullseye as fs; fs.ledger.fit_circle_3d(points)(구현을 직접 호출하려면 import match3d; match3d.fit_circle_3d(points), 원장에서 가져오려면 ops3d.get("fit_circle_3d"))
점군 → 3D 원(평면 적합 → 면 안에서 2D 원 적합). 반환값 (center, radius, normal).
fit_plane_3d로 면 (c, n)을 구하고, 면 내의 정규직교 기저 (e1, e2)에 점을 투영하여 2-D의대수적 원 피팅(|q|² = 2·cc·q + k의 lstsq)을 풀고, 중심을 3-D로 되돌린다. (N,3)에서 3점 미만은 ValueError(3점이면 면은 정확하고, 원은 3점을 지난다). center는 면 위의 3-D 점, radius는 float(음의 근은 0으로 clamp), normal은 면의 단위 법선(부호 임의). 원호의 일부만 있거나 면에서 벗어난 점이 많으면 반지름이 치우친다(대수적 피팅의 성질. 면 내 잔차는반환하지 않는다).
용도: 구멍, 플랜지, 링의 중심과 지름, distance_point_line으로 축으로부터의 편심.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py
primitive 를 입력으로 받는 것)fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment
geometry)line_from_2points · plane_from_3points · angle_3points · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line
*Provenance: match3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.