calibration_uncertainty_map — CALIB `calib_truth` op

• 資料種類:table → table

• 呼叫: import fullseye as fs; fs.ledger.calibration_uncertainty_map(calibration, image_shape, step=16, depth=None, remove_rotation=True)(要直接呼叫實作,import calib_lm; calib_lm.calibration_uncertainty_map(calibration, image_shape, step=16, depth=None, remove_rotation=True);從台帳取用則 opscalib.get("calibration_uncertainty_map"))

• GPU:無(僅 CPU 參考實作)

用法

將校正估計的共變異數映射到影像上,回傳每個像素的預測不確定度(px,給定深度 Z 時為 mm)的分布圖(table)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

Propagate the marginal covariance of the intrinsics and distortion (from camera_calibration_lm) to every grid pixel: a point fixed in the camera frame that the estimate places at p would be reprojected with a standard deviation sqrt(trace(J C Jᵀ)) (px, radial), J the 2x9 Jacobian of the projection with respect to (fx, fy, cx, cy, k1, k2, p1, p2, k3). Needs no ground truth — this is the map a real calibration can show too; the simulation checks that it is honest (Monte Carlo gate). With depth Z (mm) the map is also given in mm (std · Z / f, small-angle).

remove_rotation(既定 True)は calibration_error_map と同じ意味: カメラの向きのずれと見分けのつかない成分(主点のずれの大部分)を除く。両方を同じ設定で使うと、モンテカルロの誤差の地図と比べられる。★姿勢の不確かさは周辺化で含まれる(9x9 は全変数の共分散からの周辺)。画像の端ほど大きくなるのは、板が写っていない所を歪みの多項式が外挿するから。★線形の予測なので、外挿が大きい所では当たらない:

6 視点・σ = 0.2 px で k3 まで自由にすると、隅の予測 160 px に対しモンテカルロの実測は 55 px (k1k2p1p2 なら全体の平均で 6.42 / 6.39 px と合う。tests の実測)。

返す dict: rows・cols、std_px(地図)、mean_px・max_px・max_at、std_mm(depth)。

Raises ValueError: 共分散が無い・非有限、引数の範囲外。

詳細使用指南

• 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_error_map · calibration_next_pose

同類別(`calib_truth`)

calibration_error_map · calibration_next_pose

*Provenance: calib_lm.py — CALIB 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

calibration_uncertainty_map — CALIB calib_truth op

用法