dm_decode_modules — SYMBOL datacode2d op

• Data kinds: matrix → table

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

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

उपयोग

Data Matrix module grid (L finder और clock track सहित, 0/1) decode करके सुधारे गए codewords लौटाता है (table)।

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

Decode an (R, C) 0/1 module matrix that includes the finder L and the clock track. The grid may be given in any of the 4 rotations, optionally mirrored; the orientation is found from the function pattern (solid L + clock) and, when the pattern alone is ambiguous (a square symbol and its anti-diagonal mirror share it), from which orientation passes Reed-Solomon.

Returns

dict

text, rows, cols, n_corrected, block_corrected [int],

block_ec [EC 語数], block_capacity [floor(n_ec/2)], finder_errors

(機能 module の不一致数), codeword_index(正規化後の向き)、rotation

(度、0/90/180/270)と mirrored: 正規化 =

np.rot90(np.fliplr(g) if mirrored else g, rotation // 90)、modules(正規化後)、

codewords_raw / codewords(訂正前後、送出順)、encodations、

fixed_errors(右下固定 2x2 の不一致数、無ければ 0)。

Raises

ValueError

2-D でない・0/1 以外・NaN。

DMDecodeError

どの向きでも対応する大きさにならない、機能パターンが崩れすぎ、RS 訂正不能、符号化の矛盾。

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