rectify_to_world_plane — MV resample op

• Data kinds: image2d × table × matrix → image2d

• Call: import fullseye as fs; fs.ledger.rectify_to_world_plane(image, cam_par, pose, width, height, scale, origin=(0.0, 0.0), fill=0.0) (implementation को सीधे call करना हो तो import mvimage; mvimage.rectify_to_world_plane(image, cam_par, pose, width, height, scale, origin=(0.0, 0.0), fill=0.0), registry से लेना हो तो opsmv.get("rectify_to_world_plane"))

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

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

उपयोग

छवि को विश्व तल z=0 के सीधे दृश्य में रेक्टिफ़ाई करता है (1 पिक्सेल = scale विश्व इकाई)।

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

世界の点 (x, y, 0) を pose(ワールド → カメラの 4x4)で写し、ピンホール投影と除算モデルの歪み(cam_par に kappa があるとき)を通して入力の座標を求める。出力の行は y、列は x に沿う。origin は出力の (0, 0) に当たる世界の (x, y)。カメラの後ろへ落ちる画素は fill。空の入力(image が 0 要素)は ValueError。

Args:

image: (H, W) の画像。

cam_par: fx / fy / cx / cy(と任意で kappa)の dict。

pose: 4x4 の同次変換(ワールド → カメラ)。

width: 出力の列数。

height: 出力の行数。

scale: 1 画素あたりのワールド単位(> 0)。

origin: 出力の左上の画素が指す世界の (x, y)。

fill: 入力の外とカメラの後ろの画素の値。

Returns:

(height, width) の float 画像。

出典: R. Hartley and A. Zisserman, Multiple View Geometry, 2nd ed., ch. 2 (平面の射影変換)。

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

• machine_vision_classics 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 करते हैं)

• machine_vision_tour — py -3.11 examples/machine_vision_tour.py

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

binocular_disparity_ms · binocular_distance_ms · reconstruct_surface_stereo · map_image · change_radial_distortion_image · crop_rectangle2 · atan2_image · area_center_gray

इसी category के (resample)

map_image · change_radial_distortion_image · crop_rectangle2


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

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