Много 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; продукт не связан с их владельцами и ими не сертифицирован.