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: パスが無い。

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

• 샘플 데이터 카탈로그(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.