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 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

calibration_error_map — CALIB calib_truth op

用法