calibration_error_map — CALIB `calib_truth` op

• 데이터 종류: table → table

• 호출: import fullseye as fs; fs.ledger.calibration_error_map(calibration, K_true, dist_true, image_shape, step=16, depth=None, remove_rotation=True)(구현을 직접 호출하려면 import calib_lm; calib_lm.calibration_error_map(calibration, K_true, dist_true, image_shape, step=16, depth=None, remove_rotation=True), 원장에서 가져오려면 opscalib.get("calibration_error_map"))

• GPU: 없음(CPU 참조 구현만)

사용법

참 K·왜곡과 추정값을 비교하여 영상의 어디에서 재투영 오차(px)와 3D 오차(mm)가 큰지의 지도를 반환한다(table).

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Map, over the image, how far the estimated camera misplaces a point compared with the true camera — possible only when the truth is known (a simulated calibration). For each grid pixel p the ray of the TRUE camera through p is reprojected with the ESTIMATED camera; the map is |p̂ − p| in pixels (the error any reprojection-based measurement inherits there). With depth Z (mm), the 3-D map is the lateral distance between the points the two cameras back-project from p at depth Z.

remove_rotation(既定 True): 推定のカメラを最もよく合う小さな回転で回してから比べる。主点のずれの大部分はカメラの向きのずれと見分けがつかず、どんな使い方でも外部の姿勢に吸収されるので、残るのが「内部パラメータと歪みでしか直せない」誤差になる。回した角度は rotation_removed_deg、回す前の地図は raw_* に残す。閉形式の門(remove_rotation=False): 推定 = 真値 → 0、cx だけ δ ずれ(歪みなし)→ どこでも δ px、3D は δ·Z/fx。image_shape (H, W)、step は格子の間隔(画素)。

返す dict: rows・cols(格子の中心)、reproj_error_px(地図)、dx_px・dy_px(成分、列・行)、max_px・rms_px・max_at(row, col)、raw_rms_px・raw_max_px(回す前)、rotation_removed_deg、error_3d_mm・max_3d_mm(depth があれば)、depth。

Raises ValueError: 校正の表が不正、K が正でない、image_shape・step・depth の範囲外。

자세한 사용 가이드

• camera_calibration 패밀리 가이드

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

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

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

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

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

• poc_calibration_truth_map — py -3.11 examples/poc_calibration_truth_map.py

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

image_points_to_world_plane · contour_to_world_plane_xld · sim_caltab · disp_caltab · calibration_uncertainty_map · calibration_next_pose

같은 카테고리(`calib_truth`)

calibration_uncertainty_map · calibration_next_pose

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

calibration_error_map — CALIB calib_truth op

사용법