dm_locate — SYMBOL datacode2d op

• Datenarten: image2d → table

• Aufruf: import fullseye as fs; fs.ledger.dm_locate(image) -> 'dict' (die Implementierung direkt: import dmsym; dmsym.dm_locate(image) -> 'dict'; aus dem Register: opssymbol.get("dm_locate"))

• GPU: nein (nur CPU-Referenzimplementierung)

Verwendung

Findet eine Data Matrix im Bild und schätzt die Homographie vom Modulraum ins Bild (table).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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

記号が見つからない。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie symbol_reading

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_symbol_part_dpm — py -3.11 examples/poc_symbol_part_dpm.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

render_symbol · symbol_read_trials · symbol_read_pod · ocr_classify · ocr_read_line · ocr_read_trials

Gleiche Kategorie (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. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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