← Статьи

pyzbar не читает DataMatrix: чем читать коды «Честного знака» на Python

На вопрос «чем прочитать DataMatrix на Python» часто советуют pyzbar. Он не подходит: ZBar, на котором он построен, DataMatrix не поддерживает вовсе. Хуже всего то, что ошибки нет — decode() возвращает пустой список, и кажется, что виновата картинка. Ниже — что работает, на одном и том же коде «Честного знака».

Опыт: один код, четыре библиотеки

Код — GS1 DataMatrix с FNC1 и разделителем GS, как на упаковке: (01)04601234567893(21)5Abc12Xyz!-(93)dGVz. Картинка 208×208 пикселей, чистая, без шума. Python 3.13.

БиблиотекаРезультатЧто важно
pyzbar 0.1.9пустой списокDataMatrix не поддерживается; ошибки нет
pylibdmtx 0.1.10прочитан, GS на местена Python 3.12 и новее не импортируется без пакета setuptools (нужен модуль distutils)
zxing-cpp 3.1.1прочитан, помечен как GS1строку с GS брать из bytes, а не из text
dmr 1.2.4 (libscanner)прочитан, GS на местесделан под кадры промышленной камеры на линии

pyzbar: почему пусто

ZBar читает EAN/UPC, Code 128, Code 39, Code 93, Codabar, Interleaved 2 of 5, DataBar и QR. DataMatrix в этом списке нет, поэтому никакая настройка не поможет:

from pyzbar import pyzbar
from PIL import Image

print(pyzbar.decode(Image.open("cz.png")))
# []

Если в том же проекте нужны и штрихкоды EAN, и DataMatrix — pyzbar для штрихкодов можно оставить, а DataMatrix читать одной из библиотек ниже. Или взять одну библиотеку, которая читает всё сразу.

pylibdmtx: работает, но проверьте версию Python

pylibdmtx — обёртка над libdmtx. Код читает, разделитель GS (байт 29) сохраняет. Но последний выпуск импортирует distutils, которого с Python 3.12 нет в стандартной библиотеке, и падает с ModuleNotFoundError: No module named 'distutils'. Лечится установкой setuptools:

# pip install pylibdmtx setuptools
from pylibdmtx import pylibdmtx
from PIL import Image

print(pylibdmtx.decode(Image.open("cz.png"))[0].data)
# b'0104601234567893215Abc12Xyz!-\x1d93dGVz'

zxing-cpp: бесплатно и надёжно, но не перепутайте text и bytes

Пакет zxing-cpp (лицензия Apache 2.0) читает DataMatrix, QR и линейные коды и сам распознаёт GS1. Ловушка в том, что text — это строка для человека, со скобками вокруг идентификаторов применения и без GS. Для учётной системы и для проверки в «Честном знаке» нужна строка с GS — она в bytes:

# pip install zxing-cpp pillow
import zxingcpp
from PIL import Image

r = zxingcpp.read_barcodes(Image.open("cz.png"))[0]
print(r.content_type)  # ContentType.GS1
print(r.text)          # (01)04601234567893(21)5Abc12Xyz!-(93)dGVz
print(r.bytes)         # b'0104601234567893215Abc12Xyz!-\x1d93dGVz'

Если нужно иногда прочитать код со снимка или со скана — zxing-cpp хватит, платная библиотека не нужна.

dmr: для потока кадров с камеры на линии

dmr из libscanner решает другую задачу: конвейер, промышленная камера, тысячи кадров в час, код мелкий, смазанный или под наклоном, а ложное чтение недопустимо. На корпусе из 8959 снимков производственной линии он прочитал 99,6 % кадров без единого ложного чтения, медианное время — 7 мс на кадр на одном ядре, вместе с декодированием JPEG.

# pip install libscanner-dmr
import dmr

scanner = dmr.Scanner()
r = scanner.scan(dmr.Image("cz.png", dmr.LoadAs.GRAY).view())
if r.ok:
    print(r.text)  # b'0104601234567893215Abc12Xyz!-\x1d93dGVz'

Библиотека платная, первый месяц на машине работает без лицензии и без сети — этого хватает, чтобы проверить её на своих кадрах.

Что выбрать

  • Прочитать код с фото или скана время от времени — zxing-cpp, строку с GS брать из bytes.
  • Старый проект на pylibdmtx — оставить, на Python 3.12+ добавить setuptools.
  • Линия с камерой, нужна скорость и ноль ложных чтений — dmr; проверить на своих кадрах в пробный месяц.
  • pyzbar — только для штрихкодов и QR, не для DataMatrix.

Что делать с прочитанной строкой дальше — разобрать поля и проверить разделители — описано в статьях про разделитель GS и про проверку кода.

Попробовать

Проверить, как читается ваш код со снимка, можно в онлайн-сканере — без установки и регистрации. Документация dmr для Python — на сайте, пакет — libscanner-dmr на PyPI.

«Честный знак» — товарный знак ООО «Оператор-ЦРПТ», «GS1» — GS1 AISBL; продукт не связан с их владельцами и ими не сертифицирован.