superquadric op• 데이터 종류: points → primitive
• 호출: import fullseye as fs; fs.ledger.fit_superquadric(points) -> 'dict'(구현을 직접 호출하려면 import superquadric; superquadric.fit_superquadric(points) -> 'dict', 원장에서 가져오려면 ops3d.get("fit_superquadric"))
• GPU: 없음(CPU 참조 구현만)
점군에 초이차곡면을 least_squares 로 적합해 dict{a,eps,R,t,residual} 을 돌려줍니다.
초기 자세 = 관성 텐서 고유벡터, 초기 a = 주축 bbox 의 절반, 초기 eps=(1,1). a 는 양수로, eps 는 [0.1, 2.0] 으로 클립하여 최적화한다.
스케일: 점군을 무게중심으로 옮기고 외접 박스의 대각선 길이 L 로 나눈 무차원 좌표에서 풀어, a = L·a', t = 重心 + L·t'(重心 = 무게중심), residual = L³·residual' 로 되돌린다(★2026-11-05 적대적 검증 N5). 이전에는 원래 좌표 그대로 풀었는데, 잔차가 길이의 1.5 제곱으로 줄어들기 때문에 scipy 기본 gtol 이첫 평가에서 충족되어, s <= 1e-4 인 점군에서는 PCA 초기값을 그대로 반환했다(타원체 a=(2,1.5,1) 이 1.979/1.495/1.001, 중심이 0.17·s 어긋남). 지금은 s 에 관계없이 같은 해. 모든 점이 일치하는 점군(L == 0)은 ValueError.
dict: {'a': (3,), 'eps': (2,), 'R': (3,3), 't': (3,), 'residual': float}
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• superquadric_fit — py -3.11 examples_3d/superquadric_fit.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
superquadric)sample_surface · inside_outside · superquadric_residual
*Provenance: superquadric.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.