Настройка модуля Подсчёт уникальных посетителей🔗

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

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

Чтобы использовать модуль, нужно включить и настроить его.

Для этого нужно запустить приложение Macroscop Конфигуратор, открыть страницу /config/svg/ico-tab-cams.png Камеры, в списке в левой части страницы выбрать камеру, переключиться на вкладку Аналитика в правой части страницы и включить модуль с помощью переключателя /img/ico-switch-on.png.

../../_images/module-turn12.png

При нажатии кнопки /img/ico-settings.png открывается окно настройки модуля.

Примечание

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

Основные настройки🔗

На вкладке Основные настройки задаются ключевые параметры работы модуля.

../../_images/configure-visitors-general.png

Минимальный размер и Максимальный размер: Позволяют задать (с помощью рамок) минимальный и максимальный размеры детектируемого лица. Слишком малый минимальный размер может привести к появлению ложных распознаваний из-за плохого качества лиц малого размера.

Примечание

Будут распознаваться только те лица, размеры которых попадают в заданный диапазон: лицо не должно быть меньше установленного минимального размера и не должно превышать установленный максимальный размер.

Совет

При настройке минимальных и максимальных размеров объекта можно развернуть окно настройки на полный экран — это позволит задать рамки размеров точнее, чем в открытом окне по умолчанию.

Чувствительность поиска лиц в кадре: Чем выше чувствительность, тем ниже минимальное качество лиц, необходимое для обнаружения. Высокое значение может помочь при плохом освещении, но также может привести к ошибочным обнаружениям, а также к обнаружению лиц плохого качества. Низкое значение снижает способность модуля обнаруживать повёрнутые в сторону от камеры лица. Допустимый перечень значений: Минимальная, Низкая, Средняя, Высокая, Максимальная; значение по умолчанию: Средняя.

Минимальное время перед повторным определением человека: Минимальное время между нахождением лица одного и того же человека. Защищает от появления одинаковых записей в ленте при нескольких последовательных случаях появления одного и того же человека в кадре. Допустимый перечень значений: Не ограничивать, 5 секунд, 30 секунд, 1 минута; значение по умолчанию: Не ограничивать.

Распознавать лица в масках и Распознавать повёрнутые лица: позволяют более гибко настроить модуль: если параметры отключены, то это позволит снизить число потенциально ложных срабатываний, а если параметры включены, то модуль более точно обнаруживает и распознаёт лица.

Примечание

Данные параметры влияют только на возможность идентификации лиц в масках и с повёрнутыми лицами, обнаружение будет производиться в любом случае.

Примечание

В Задачах по событию можно задать сценарии по признаку наличия или отсутствия маски на лице человека, а также по параметру отворота лица от камеры.

Распознавать больше 10 лиц одновременно: позволяет распознавать более 10 лиц одновременно.

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

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

В некоторых ситуациях это может привести к увеличению количества повторно или ошибочно распознанных лиц.

Зона детектирования🔗

На вкладке Зона детектирования задается зона, в которой будет производиться поиск лиц. По умолчанию зона детектирования занимает весь кадр.

../../_images/configure-complete-area.png

Советы по настройке модуля🔗

Ниже приведены рекомендации по более тонкой настройке модуля «на месте». Контролируйте результаты настроек в приложении Macroscop Клиент: в ленте панели обнаруженных лиц и/или в отчёте Обнаружение лиц (см. Подсчёт уникальных посетителей).

Шаг 1. Настройте модуль таким образом, чтобы модулем детектировались все лица людей, которых нужно подсчитывать. При этом постарайтесь добиться того, чтобы каждый человек за время одного прохода детектировался только один раз. Для этого:

  • Исключите из зоны детектирования лишние области кадра; в том числе те, в которых могут появиться лица, не являющиеся посетителям; а также те, в которых качество лиц недостаточно для их точного сравнения с ранее задетектированными образцами (а также, для сотрудников, — с образцами в базе).

  • Отрегулируйте минимальные и максимальные размеры лица таким образом, чтобы не детектировались лишние лица: например, на заднем и/или переднем плане.

  • Установите Минимальное время перед повторным определением человека таким образом, чтобы минимизировать возможность повторного детектирования лица, подлежащего подсчёту.

На качественное детектирование посетителей также могут влиять следующие настройки: Чувствительность поиска лиц в кадре, Распознавать повёрнутые лица, Распознавать лица в масках, Распознавать больше 10 лиц одновременно, Режим низкой задержки.

Шаг 2. Настройте модуль для правильного подсчёта уникальных посетителей:

  • Отрегулируйте Чувствительность поиска лиц в кадре.

  • Протестируйте, как влияет на результаты подсчёта уникальных посетителей включение опции Подсчитывать повёрнутые лица в параметрах отчёта (в приложении Macroscop Клиент).

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

При настройке могут пригодиться следующие материалы:

База лиц🔗

На вкладке База лиц указываются параметры доступа к базе данных модуля.

../../_images/configure-complete-db.png

Доступны два варианта размещения базы: Локальная и Удаленная.

Если распознавание выполняется только на одном сервере, рекомендуется хранить базу на этом же сервере и выбирать вариант Локальная.

Если распознавание осуществляется на нескольких серверах, следует размещать базу только на одном сервере. При этом для всех камер нужно выбрать вариант Удаленная и задать параметры подключения к базе данных: адрес сервера, имя и пароль администратора базы данных. Этот же вариант следует использовать, когда база данных модуля развёрнута на одном сервере, а камера с включенным модулем прикреплена к другому.

Примечание

Macroscop версии 3.6 и ниже для ведения базы данных модуля использует СУБД Firebird со следующими значениями по умолчанию:

  • Порт: 3050

  • Имя пользователя: SYSDBA

  • Пароль: masterkey

Примечание

Начиная с версии Macroscop 4.0 ведение базы данных модуля передано СУБД PostgreSQL со следующими значениями по умолчанию:

  • Порт: 5432

  • Имя пользователя:

    • Для Windows: postgres

    • Для Linux: macroscop

  • Пароль: masterkey

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

PostgreSQL не разрешает удалённый доступ к базам по умолчанию, в связи с чем его необходимо включить вручную при использовании удалённых баз данных. Настройка выполняется на сервере, хранящем удалённую БД, и различается для Windows (см. Использование PostgreSQL на Windows) и GNU/Linux (см. Использование PostgreSQL на Linux).

При первом запуске сервера после обновления Macroscop до версии 4.0 и выше, существующая база данных модуля будет автоматически трансформирована в совместимую с PostgreSQL.

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

При подключении к удалённой базе данных необходимо использовать имя и пароль пользователя СУБД, актуальные для хранящего базу сервера.

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

Независимо от того, на каком сервере хранится база, события распознавания (дата/время распознавания; координаты распознанного объекта в кадре; привязка распознанного объекта к базе) всегда будут храниться на том сервере, к которому привязана камера с данными событиями.

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

Загрузка данных из базы, размещённой на удалённом сервере, может существенно затянуться.

Примечание

При использовании удалённой базы будет задействован механизм репликации удалённой базы.

Проверить доступ к базе можно нажатием на ссылку Проверка соединения: если сервер недоступен, то будет выведено соответствующее сообщение.

Можно задать собственную базу лиц для отдельной камеры или групп камер через поле Идентификатор базы.

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

При включении модуля поле Идентификатор базы изначально не отображается.

Примечание

Для использования данной возможности необходимо задать Идентификатор базы через REST API.

../../_images/base-identifier-on.png

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

Использование модуля начнётся только после применения настроек.