find_marks_and_pose — CALIB calibrate op

• Data kinds: image2d → table

• Call: import fullseye as fs; fs.ledger.find_marks_and_pose(image, cam_par, caltab, thresh=0.5, max_reproj_rms=3.0) (implementation को सीधे call करना हो तो import caltab; caltab.find_marks_and_pose(image, cam_par, caltab, thresh=0.5, max_reproj_rms=3.0), registry से लेना हो तो opscalib.get("find_marks_and_pose"))

• HALCON समकक्ष: find_marks_and_pose (अर्थ और parameters समझने के लिए HALCON reference उपयोगी है)

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

mark पहचान + calibration plate का pose अनुमान (plane homography → pose) (find_marks_and_pose)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

対応づけは行優先ソートではなく ホモグラフィ誘導: 検出マークと理想格子の 4 隅(row±col の極値)から初期 H を作り、理想点を投影して最近傍マークを 1 対 1 に割り当て、全対応で H を再推定(2 反復)。板の面内回転が ±45° 未満なら傾き(rx, ry)の大きさに関係なく正しく対応する(2026-09-02 以前は少しの傾きで行が交錯し、深度が数百 mm ずれても無警告だった)。

fail-closed: マークが 4 個未満/対応が 4 組未満/再投影 RMS が max_reproj_rms [px] を超えるときは ValueError(None で無効化可)。

戻り値: marks (M,2) 対応づいた検出マーク(ideal_index の順)、pose 4x4、homography (x,y)→(col,row)、reproj_rms [px]、residuals (M,)、n_marks、reproj_margin(max_reproj_rms - reproj_rms [px]。拒否の線までの余裕で、小さいほど「かろうじて通った」。max_reproj_rms=None なら None)。world は caltab["points"] の (y, x) をそのまま (x, y, 0) とする。

उपयोग की विस्तृत guide

• camera_calibration family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_caltab_chain_truth — py -3.11 examples/poc_caltab_chain_truth.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

image_points_to_world_plane · contour_to_world_plane_xld · sim_caltab · disp_caltab · calibration_error_map · calibration_uncertainty_map · calibration_next_pose

इसी category के (calibrate)

camera_calibration · hand_eye_calibration · camera_calibration_lm · stereo_calibration_lm


*Provenance: caltab.py — CALIB operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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