gen_radial_distortion_map — CALIB plane op

• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

• Call: import fullseye as fs; fs.ledger.gen_radial_distortion_map(cam_par, kappa, shape) (implementation को सीधे call करना हो तो import calib; calib.gen_radial_distortion_map(cam_par, kappa, shape), registry से लेना हो तो opscalib.get("gen_radial_distortion_map"))

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

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

उपयोग

radial distortion का inverse map (row_map, col_map) बनाता है (gen_radial_distortion_map)।

Output pixel (row, col) → input coordinate। model एक प्रथम-क्रम polynomial है: principal point से pixel offset (x, y), r^2 = x^2 + y^2 के लिए input = principal point + (x, y) * (1 + kappa r^2) (kappa की इकाई 1/pixel²; cam_par के fx/fy उपयोग नहीं होते)। ★यह division model (mvimage.distort_division / undistort_division, u = d / (1 + kappa |d|^2)) का सटीक inverse नहीं, बल्कि उसका प्रथम-क्रम सन्निकटन है। दोनों में एक ही kappa देने पर चुपचाप अंतर आता है:

640x480 और principal point (320, 240) पर kappa = -5e-7 के लिए अधिकतम 4.28 px, -2e-6 के लिए अधिकतम 46.73 px (2026-11-09 का माप)। division model के distortion को सटीक हटाने के लिए mvimage.change_radial_distortion_image (cam_out का kappa 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 करते हैं)

• (अभी कुछ नहीं)

वे अगले 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 के (plane)

image_to_world_plane · image_points_to_world_plane · contour_to_world_plane_xld · gen_image_to_world_plane_map


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

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