Требования, ограничения и рекомендации🔗

Детектирование

Модуль способен детектировать в кадре одновременно до 10 людей без маски (при достаточной вычислительной мощности).

Модуль не идентифицирует лица (не может отличить одного человека от другого или сравнить лицо с лицами из базы), только находит в кадре людей без маски.

При обнаружении нарушения (отсутствия маски) модуль кратковременно обведёт лицо человека красной рамкой в клиентском приложении и создаст запись в журнале событий. Повторное обнаружение нарушения на том же человеке станет возможным только после того, как человек, обнаруженный в кадре без маски, исчезнет из кадра как минимум на 3 секунды (например, выйдет за пределы кадра или полностью закроет лицо).

Аппаратное и программное обеспечение

Предупреждение

Перед использованием нейросетевых возможностей модуля необходимо установить пакет установить пакет Macroscop Нейросети.

Для режима Продвинутый (с GPU) требуются:

Для использования данного нейросетевого модуля требуются:

  • Процессор с поддержкой инструкций AVX;

  • Видеокарта (GPU) NVIDIA с индексом вычислительной мощности не ниже 6.5 и объёмом памяти не ниже 4GB; при этом характеристики и производительность видеокарты должны быть не ниже, чем у модели NVIDIA GTX 1650 Super;

  • Версия драйвера видеокарты не ниже 460;

  • Файл подкачки (swap) размером не менее половины от общего объёма оперативной памяти.

Если планируется использование модуля на виртуальной машине, может дополнительно потребоваться:

  • Включить поддержку AVX инструкций в настройках гостевой машины;

  • Использовать драйвера GRID для виртуализации GPU.

Предупреждение

Macroscop должен использовать выбранные для работы нейросетей видеокарты в монопольном режиме. Не допускается использование такой карты для других приложений или задач, потребляющих ресурсы GPU, в том числе для отображения видео. Одновременное использование видеокарты для нескольких задач может привести к некорректной работе системы: от снижения производительности аналитики до нестабильной работы сервера.

Предупреждение

Нейросеть работает только в 64-битной версии Macroscop.

Предупреждение

При обновлении Macroscop до другой версии необходимо также обновить до соответствующей версии пакет установить пакет Macroscop Нейросети.

Настройка

Задание слишком малого минимального размера лица может привести к появлению ложных срабатываний из-за плохого качества изображения.

Зона детектирования может быть задана произвольной формы.

Маски

Поддерживаемые типы масок (примеры):

/analytics/mask-detector/img/example-mask-1.png /analytics/mask-detector/img/example-mask-2.png /analytics/mask-detector/img/example-mask-3.png /analytics/mask-detector/img/example-mask-4.png /analytics/mask-detector/img/example-mask-5.png /analytics/mask-detector/img/example-mask-6.png

Допустимые цвета: белый, черный, желтый, различные оттенки зеленого, синего и красного.

Лицо, закрытое рукой или шарфом, будет вызывать срабатывание, если не перекрыта область носа.

Видеопоток
  • Разрешение не ниже HD (1280x720).

  • Частота кадров: не менее 15 кадров в секунду.

Освещение и качество изображения
  • Освещение лиц в кадре должно быть равномерным и постоянным.

  • Если камера установлена напротив яркого источника света (солнце за дверью входа и т.п.), то необходимо настроить экспозицию (или яркость) таким образом, чтобы лицо в кадре было светлым. При этом допускается пересвеченный фон.

  • Качество изображения должно быть не ниже среднего. Не должно быть существенных артефактов сжатия.

  • Не допускается размытие лиц движущихся людей.

  • Изображение должно быть цветным.

Сцена и расположение камеры
  • Лица людей должны быть полностью видны в кадре.

  • В кадре не должно быть дающих отражения зеркальных поверхностей: стекол, зеркал и т.п.

  • Не допускается сильный боковой источник света (солнечный свет из окна), из-за которого одна половина лица оказывается пересвеченной.

  • Допускается размещать камеру выше уровня лиц детектируемых людей, прямо по направлению взгляда. В таком случае угол наклона камеры не должен превышать 35°.

  • Расстояние между зрачками лиц детектируемых людей в кадре должно составлять не менее 30 пикселей.

  • Камера должна быть направлена прямо на лица детектируемых людей. Угол между направлением лица и осью объектива: не должен превышать 30°.

Примеры нарушения требований

Перекрытие:

/analytics/mask-detector/img/example-overlap-ok.png

/analytics/mask-detector/img/example-overlap-err.png

Х

Освещенность:

/analytics/mask-detector/img/example-illumination-ok.png

/analytics/mask-detector/img/example-illumination-err-1.png

/analytics/mask-detector/img/example-illumination-err-2.png

Х

Х

Размытие в движении:

/analytics/mask-detector/img/example-blur-ok.gif

/analytics/mask-detector/img/example-blur-err.gif

Х

Недопустимое расстояние между зрачками глаз:

/analytics/mask-detector/img/example-pupils-ok.png

/analytics/mask-detector/img/example-pupils-err.png

30 пикс

15 пикс

Х

Качество видеопотока:

/analytics/mask-detector/img/example-quality-ok.png

/analytics/mask-detector/img/example-quality-err.png

Х

Наклон камеры:

/analytics/mask-detector/img/example-tilt-35.png

/analytics/mask-detector/img/example-tilt-50.png

/analytics/mask-detector/img/example-tilt-70.png

35°

50°

70°

Х

Боковой источник света:

/analytics/mask-detector/img/example-side-ok.png

/analytics/mask-detector/img/example-side-err.png

Х

Зеркальные поверхности:

/analytics/mask-detector/img/example-mirror-ok.png

/analytics/mask-detector/img/example-mirror-err.png

Х

Горизонтальный поворот камеры от плоскости лица:

/analytics/mask-detector/img/example-pan-0.jpg

/analytics/mask-detector/img/example-pan-15.jpg

/analytics/mask-detector/img/example-pan-30.jpg

/analytics/mask-detector/img/example-pan-45.jpg

/analytics/mask-detector/img/example-pan-60.jpg

/analytics/mask-detector/img/example-pan-90.jpg

15°

30°

45°

60°

90°

Х | Х

Черно-белое изображение (ночной режим):

/analytics/mask-detector/img/example-color-on.png

/analytics/mask-detector/img/example-color-off.png

Х

Рекомендуемые настройки камер
  • Качество: наивысшее.

  • Битрейт: максимально возможный.

  • Профиль: максимально возможный.

  • Интервал I-кадра (GOV): 50.

  • Сглаживание потока: выключено.

  • Экспозиция и яркость: такие, чтобы для данной сцены лицо было отчетливо видно (если камера направлена на источник света, то допускается пересвеченный фон).

  • Скорость затвора: нельзя ставить слишком низкий (больше 1/50), поскольку в таком случае появляется эффект размытия движущихся объектов.