binocular_disparity_ms — MV stereo op

• Data kinds: image2d × image2d → table

• Call: import fullseye as fs; fs.ledger.binocular_disparity_ms(left, right, max_disp=32, window=5, P1=5.0, P2=50.0, paths=4, lr_tolerance=1.0) (implementation को सीधे call करना हो तो import mvstereo; mvstereo.binocular_disparity_ms(left, right, max_disp=32, window=5, P1=5.0, P2=50.0, paths=4, lr_tolerance=1.0), registry से लेना हो तो opsmv.get("binocular_disparity_ms"))

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

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

उपयोग

सेमी-ग्लोबल मैचिंग से रेक्टिफ़ाइड स्टीरियो का डिस्पैरिटी निकालता है, बाएँ-दाएँ जाँचता है और सबपिक्सेल तक इंटरपोलेट करता है।

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

左基準と右基準の視差を stereo.disparity_sgm で 1 回ずつ計算し、対応点で lr_tolerance より食い違う画素と参照できない左端の列を無効にする。残りの画素は SAD の 3 点放物線で小数の視差へ補間する。無効の画素は disparity が NaN になる。空の入力(left が 0 要素)は ValueError。

Args:

left: 左の画像 (H, W)。視差はこの画像を基準にする。

right: 右の画像 (H, W)。

max_disp: 探す視差の上限(画素、>= 1)。

window: census と SAD の窓(奇数)。

P1: 視差 1 の段差の罰則。

P2: 視差 2 以上の段差の罰則。

paths: 集約の方向数(2 / 4)。

lr_tolerance: 左右一致の許容差(画素)。

Returns:

disparity(float、無効は NaN)、valid(bool)、score(0..1、大きいほど

コストの谷が深い)を持つ dict。

出典: H. Hirschmüller, IEEE Trans. PAMI 30(2), 328-341 (2008), doi:10.1109/TPAMI.2007.1166。

उपयोग की विस्तृत 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

• poc_3d_sensor_modalities — py -3.11 examples/poc_3d_sensor_modalities.py

• poc_real_stereo_multiscanline — py -3.11 examples/poc_real_stereo_multiscanline.py

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

map_image · rectify_to_world_plane · change_radial_distortion_image · find_ncc_models · run_bg_esti · give_bg_esti · update_bg_esti · classify_class_gmm

इसी category के (stereo)

binocular_distance_ms · reconstruct_surface_stereo


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

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