sim_checkerboard — CALIB checkerboard op

• 数据种类:无 → table(仅由参数决定的算子 —— 不接受图像或数据输入)

• 调用: import fullseye as fs; fs.ledger.sim_checkerboard(pattern_size, square_size, K, dist, pose, image_shape, supersample=3, margin=1.0, blur_sigma=0.0, noise_sigma=0.0, seed=0, black=0.1, white=0.9, background=0.5)(要直接调用实现,import calib_lm; calib_lm.sim_checkerboard(pattern_size, square_size, K, dist, pose, image_shape, supersample=3, margin=1.0, blur_sigma=0.0, noise_sigma=0.0, seed=0, black=0.1, white=0.9, background=0.5);从台账取用则 opscalib.get("sim_checkerboard"))

• GPU:无(仅 CPU 参考实现)

用法

用已知的 K、畸变与位姿合成棋盘格图像,并连同各角点的真实像素一起返回(table)。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

Render a checkerboard seen through a camera with known intrinsics K (3x3 or {fx, fy, cx, cy}), distortion dist ([k1, k2, p1, p2(, k3)], OpenCV order) and board pose pose (board -> camera 4x4), with the true pixel of every inner corner.

描画は投影の式とは逆向きの経路: 画素(supersample x supersample の標本)ごとに歪みを固定点反復で外し、視線を板の平面に当てて板の座標を求め、その色(黒・白・板の外の余白 margin マス分は白、その外は background)を塗って平均する。真の角は板の点を前向きに投影した値。だから検出の誤差は「描画の標本化 + 検出器」の誤差で、式の写しにはならない。blur_sigma(画素)でガウスぼけ、noise_sigma で正規雑音。

返す dict: image (H, W) [0, 1]、corners (N, 2) (row, col)、object_points (N, 2) (x, y)、visible(全部の角が画像の内側 2 画素以上にある)、pattern_size、square_size、K、dist、pose。

Raises ValueError: 引数の形・範囲(K が正でない、姿勢が剛体でない、板が背後にある、supersample が 1〜8 の外、色が [0, 1] の外)。

详细使用指南

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

同类别(checkerboard)

checkerboard_points · find_checkerboard_corners


*Provenance: calib_lm.py — CALIB 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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