← Статьи

Много DataMatrix на одном снимке: как прочитать все коды коробки или листа

Коробка с пачками, лоток с флаконами, лист этикеток после принтера, паллета при агрегации — на одном снимке десятки кодов DataMatrix, и нужны все. Обычный ридер ищет один код: читает первый попавшийся и останавливается или перебирает весь кадр и не укладывается в разумное время. Ниже — как читать все коды сразу и сколько это занимает.

Почему это трудно

  • Кодов много, а каждый мелкий. Чтобы в кадр поместилась коробка, камеру отодвигают, и модуль кода становится 2–4 пикселя. Сколько пикселей нужно на модуль — в статье о разрешении камеры.
  • Полный перебор дорог. Ридер, который ищет код по всему кадру, на снимке 12 Мп с десятками символов упирается в предел числа кандидатов: часть кодов он просто не успевает проверить.
  • Коды мешают друг другу. Соседние символы, края этикеток и текст сбивают поиск рамки кода.

Как это делаем мы

В наших библиотеках dmr (DataMatrix) и unir (DataMatrix, QR, штрихкоды) встроена небольшая нейросеть — сеть-разведчик. За десятки миллисекунд она находит на кадре места кодов, и каждое место читается отдельной вырезкой: сначала узкой, вплотную к коду, а если не прочиталось — пошире. Вырезки разбираются параллельно на всех ядрах. Отдельный файл модели не нужен, сеть включается сама (режим «Авто»): в dmr — когда нужно найти больше одного кода, в unir — по умолчанию.

Сколько это занимает

Снимки с 16 кодами DataMatrix, dmr 1.2.1, 8 ядер x86:

СнимкиС сетью-разведчикомБез сети
12 Мп, как с камеры96,8 % кодов, 0,45 с на снимок43,5 % кодов, 1,1 с
вырезки настоящих снимков88,2 % кодов23,1 %
от 1 до 10 кодов на снимке97 % кодов—

Ложных чтений не было ни в одном прогоне.

На маленьком компьютере всё медленнее. Raspberry Pi 4, unir 1.2.15, лист A4 с 20 GS1 DataMatrix, кадр промышленной камеры 2416×2024 (5 Мп), 20 кадров: медиана 6,2 с на кадр в один поток и 1,9 с в четыре потока. Если же нужен один код, а не все, тот же кадр читается за 0,25 с. Подробнее — в статье о Raspberry Pi.

Как включить

В Python — режим «все коды» и список результатов:

# pip install libscanner-unir
import unir

result = unir.scan_file("korobka.jpg", unir.Settings.multi(0))   # 0 — все, сколько найдётся
for code in result.codes:
    print(code.symbology_name, code.text)

Если известно, сколько кодов должно быть (например, 20 пачек в коробке), передайте число вместо нуля: ридер не станет искать дальше, когда найдёт столько. В командной строке то же самое — ключ --codes:

unir --codes 0 korobka.jpg
unir --folder ./snimki --codes 20 > result.tsv

Число потоков задаётся настройкой threads (ключ --threads): по умолчанию берутся все доступные процессу, в контейнере с квотой процессора — не больше квоты. Если вы сами раздаёте кадры по своим потокам, ставьте 1.

Советы по съёмке

  • Разрешение под самый мелкий код. Камера должна давать не меньше 2–3 пикселей на модуль у кода на краю кадра, а не в центре.
  • Свет без бликов. Плёнка термоусадки и глянец дают блики, которые закрывают часть символа. Рассеянный свет сбоку обычно помогает больше, чем более дорогая камера.
  • Резкость по всей коробке. Если коробка высокая, верхние и нижние ряды пачек расходятся по резкости — закройте диафрагму или поднимите камеру.
  • Сверяйте число кодов. Для агрегации важно, что прочитаны все: сравнивайте число прочитанных с ожидаемым и отправляйте коробку на пересъёмку, если не сошлось.

Попробовать

Снимок с несколькими кодами можно проверить в онлайн-сканере — без установки. Библиотеки работают первый месяц без лицензии: этого хватит, чтобы прогнать их на своих кадрах. Документация — unir и dmr. Если нужно подстроить чтение под вашу линию — доработка под заказ, оценка на ваших кадрах бесплатно.

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