dm_locate — SYMBOL datacode2d op

• Data kinds: image2d → table

• Call: import fullseye as fs; fs.ledger.dm_locate(image) -> 'dict' (implementation को सीधे call करना हो तो import dmsym; dmsym.dm_locate(image) -> 'dict', registry से लेना हो तो opssymbol.get("dm_locate"))

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

उपयोग

image में Data Matrix खोजकर module space से image तक का homography estimate करता है (table)।

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

Locate a dark-on-light ECC200 symbol (quiet zone >= 1 module). Global binarisation (Otsu start, then the midpoint of the dark/light means), dark pixels grouped after a distance-based closing at several radii (so separated dot-peen dots join), near max-area quadrilateral in the convex hull, sub-pixel edge lines (grey-level threshold crossings, inward outliers from the clock gaps trimmed), corners = line intersections, then the size and which corner is the L corner are chosen by the agreement of the sampled function pattern (finder + clock + alignment) for every supported size and corner correspondence.

Returns

dict

homography 3x3(module 空間 [x=列, y=行, 1] → 画像 [列, 行, w])、rows, cols,

corners (4, 2) 画素の (行, 列)、順は module 空間の (0,0), (C,0), (C,R), (0,R)、

module_px, score(機能パターンの一致率), threshold(大域閾値 / global threshold)。

Raises

ValueError

2-D でない・NaN/inf・小さすぎる。

DMDecodeError

記号が見つからない。

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

• symbol_reading 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_symbol_part_dpm — py -3.11 examples/poc_symbol_part_dpm.py

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

render_symbol · symbol_read_trials · symbol_read_pod · ocr_classify · ocr_read_line · ocr_read_trials

इसी category के (datacode2d)

qr_encode · qr_decode_modules · qr_locate · qr_sample · qr_read · dm_encode · dm_decode_modules · dm_sample

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

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