calib_pack_load — DRIVE tacscalib op

• 데이터 종류: text × scalar × scalar → table

• 호출: import fullseye as fs; fs.ledger.calib_pack_load(path: 'str', pitch_mm: 'float', ball_radius_mm: 'float') -> 'dict'(구현을 직접 호출하려면 import tacscalib; tacscalib.calib_pack_load(path: 'str', pitch_mm: 'float', ball_radius_mm: 'float') -> 'dict', 원장에서 가져오려면 opsdrive.get("calib_pack_load"))

사용법

캘리브레이션 팩(npz) → dict. 키 f0(배경 (H, W, 3) uint8), imgs((N, H, W, 3)), touch_center((N, 2) = (열 x, 행 y)), touch_radius((N,) px)를 필수로 하며, 중심은 (행, 열)로 재배열해 centers로 반환합니다.

pitch_mm [mm/px] 와 ball_radius_mm 는 호출 측이 준다(팩 안에 없다). 반환: f0·imgs·centers (N, 2)· radii (N,) [px]·pitch(m/px)·pitch_mm·R_mm·R_px(= 반경 / 피치)·n. 데이터 위치는 호출 측이 환경 변수(예 FULLSEYE_TAXIM_DATA)로부터 구성한다.

Raises ValueError: 키 누락(철자 오류도)/ 형태 불일치 / 이미지 0 장 / 중심이 비유한 / 반경 ≤ 0 / pitch·구 반경 ≤ 0. FileNotFoundError: 경로가 없다.

빈 입력(path 이(가) 빈 문자열)은 ValueError 를 발생시킨다.

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_tacscalib_sphere_lut — py -3.11 examples/poc_tacscalib_sphere_lut.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

같은 카테고리(tacscalib)

sphere_normals_known · lights_fit_from_sphere · membrane_predict_rgb · gradient_lut_build · gradient_lut_invert · normal_error_map · sphere_cap_height · field_position_sweep

*Provenance: tacscalib.py — DRIVE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.