Конфигурация

Настройка OMNI-агента осуществляется через веб-интерфейс и папку воркспейса, где хранятся файлы конфигурации, файлы активации, локальная база данных и прочие необходимые для работы агента файлы.

Для перехода к настройкам агента через веб-интерфейс нажмите на значок Настройки в правом верхнем углу веб-интерфейса OMNI-агента.

Папка воркспейса OMNI-агента по умолчанию расположена по адресу:

• Linux: ~/.local/share/OMNIAgent
• Windows: %LocalAppData%/OMNI Agent

Вы можете настроить OMNI-агент в ручном режиме через редактирование файлов конфигурации в папке config. Файлы конфигурации с настройками по умолчанию доступны для ознакомления в папке config.default. Обратите внимание, что значения параметров, указанных в файлах из папки config, имеют приоритет над значениями параметров для файлов из папки config.default.

Ниже представлены основные настройки, которые можно изменить через веб-интерфейс или отредактировать в файлах конфигурации run_params.json и log_params.json. После изменения настроек необходимо перезапустить OMNI-агент.

Включение/отключение основных модулей

Все параметры, указанные ниже, настраиваются в файле конфигурации run_params.json.

Для включения/отключения модуля детекции тел установите значение параметра pipelines.body_detector.enabled:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

Для включения/отключения модуля детекции лиц установите значение параметра pipelines.face.enabled:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

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

Для включения/отключения определения пола и возраста установите значение параметра pipelines.age_gender.enabled:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

Для включения/отключения определения эмоций установите значение параметра pipelines.emotions.enabled:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

Для включения/отключения детектора маски на лице установите значение параметра pipelines.mask_attribute.enabled:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

Перечисленные выше модули можно также включить/отключить через веб-интерфейс агента. Для этого нажмите на Настройки в правом верхнем углу веб-интерфейса OMNI-агента, выберите Продвинутые настройки и активируйте необходимые опции (Детекция тел, детекция лиц, детекция маски на лице человека, определение возраста и пола, определение эмоций).

Включение/отключение анонимного режима

В целях защиты персональных данных в OMNI-агенте предусмотрен анонимный режим, включенный по умолчанию. В анонимном режиме изображения лиц не передаются на OMNI Platform, что обеспечивает защиту персональных данных и исключает возможность распознавания человека вне системы. Включить/отключить анонимный режим можно через веб-интерфейс агента или через редактирование файла run_params.json.

Для включения/отключения анонимного режима через веб-интерфейс нажмите на значок Настройки в веб-интерфейсе OMNI-агента и выберите нужную опцию в открывшейся вкладке.

Для включения/отключения анонимного режима через файл конфигурации установите значение параметра anonymous_mode:(Boolean) как “true” (модуль включен) или “false” (модуль отключен).

Подключение прокси-сервера

В случае если доступ пользователя к сети Интернет осуществляется через прокси-сервер, его подключение также потребуется для установки и настройки агента. Для использования прокси-сервера нажмите на значок Настройки в веб-интерфейсе OMNI-агента и выберите Системный (System) или Свой (Custom) прокси-сервер в открывшейся вкладке. При выборе настраиваемого прокси-сервера укажите его адрес в специальном поле. Далее нажмите кнопку Сохранить.

Изменение стандартного порта веб-конфигуратора

Все параметры, указанные в этом разделе, настраиваются в файле конфигурации run_params.json.

По умолчанию веб-конфигуратор запускается на порту 8080. Для изменения порта в файле конфигурации необходимо добавить поле http_server_port: (int) и указать в нем желаемый порт открытия веб-конфигуратора.

Изменение пороговых значений матчеров лиц и тел

Все параметры, указанные ниже, настраиваются в файле конфигурации run_params.json.

Матчер - это компонент 3DiVi Face SDK, выполняющий операции сравнения биометрических шаблонов лиц:

• Верификация 1:1 - сравнение двух биометрических шаблонов (лиц) между собой, оценка совпадения;
• Идентификация 1:N - сравнение одного биометрического шаблона (лица) с другими шаблонами (лицами), поиск и оценка совпадений.

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

Настройки матчера лиц:

• faR: False acceptance rate (FAR) - коэффициент ложной идентификации, который показывает уровень сопротивления системы ошибкам ложной идентификации. Такая ошибка возникает, когда биометрическая система определяет новое лицо как ранее распознанное. Коэффициент измеряется количеством ложных распознаваний, деленным на общее количество попыток распознавания. Изменить значение faR можно в параметре desired_far (float). По умолчанию в файле конфигурации указано значение faR, равное 1e-5.

• frR: False rejection rate (FRR). В случае если система не способна распознать ранее обнаруженное лицо, происходит ложное отклонение. Коэффициент ложного отклонения показывает процент попыток распознавания с ложным отклонением. Изменить значение frR можно в параметре desired_frr (float). По умолчанию в файле конфигурации указано значение frR, равное 0.

Значения faR и frR можно также установить в Продвинутых настройках веб-интерфейса OMNI-агента.

Настройки матчера тел:

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

• Пороговое значение достоверности детекции тела указано в параметре detector_confidence (float) и по умолчанию равно 0,9. Диапазон значений: от 0 до 1.

• Пороговое значение достоверности сравнения тел указано в параметре cos_reident_confidence (float) и по умолчанию равно 0,6. Диапазон значений: от -1 до 1.

Просмотр логов/изменение уровня логирования

Просмотреть логи можно в файле logfile_*.log в папке log. Чтобы изменить уровень логирования, перейдите в файл конфигурации log_params.json и укажите значение для параметра sev_level(string). Доступные уровни логирования: TRACE, DEBUG, INFO, WARNING, ERROR, FATAL (перечислены по возрастанию степени важности).

Передача данных через вебхуки

Для настройки передачи процессов через вебхуки перейдите в файл конфигурации run_params.json и укажите значения для параметра webhook_tracking_subscribers. Параметр представляет собой список объектов, описывающих адрес сервера, принимающего процессы с OMNI-агента и представлен в двух версиях:

Версия 1

{
    "url": "http://127.0.0.1:5000/trigger" // указание адреса с эндпоинтом
}

Версия 2 (установлена по умолчанию)

{ 
    "host": "127.0.0.1", // адрес
    "port": "5000", // порт
    "is_secured": false, // флаг http/https
    "path": "/trigger" // эндпоинт
}

Добавить вебхук также можно в Продвинутых настройках веб-интерфейса OMNI-агента.

Мультикамерность

Подключение дополнительного видеопотока (камеры)

OMNI-агент поддерживает подключение к нескольким видеопотокам (камерам).

Для подключения дополнительного видеопотока через веб-интерфейс OMNI-агента нажмите Добавить камеру на странице камер и укажите IP/USB камеру.

Чтобы добавить дополнительный видеопоток к существующему агенту через редактирование файла конфигурации, выполните следующие шаги:

1. В файле конфигурации run_params.json создайте новый объект камеры в массиве web_cams. Для этого просто скопируйте уже существующий объект камеры из массива web_cams.
2. В параметре stream нового объекта камеры укажите IP-адрес или ID новой подключаемой камеры. Для USB камер дополнительно требуется указать размер кадра: width и height.
3. Запустите и активируйте OMNI-агент.

В результате, OMNI-агент будет передавать данные в платформу уже с двух видеопотоков (камер).

Для подключения и работы дополнительных видеопотоков потребуется машина со следующими расчетными характеристиками:

• ЦП: Число ядер = 1 ядро + 3 x число видеопотоков @3ГГц с поддержкой AVX. При отключении одного из модулей (лицо/тело) убирается 1 ядро процессора. В этом случае число ядер = 1 + 2 x число видеопотоков.
• ОЗУ: 1 ГБ + 1 ГБ x число видеопотоков. Указан необходимый свободный объем ОЗУ. При отключении одного из из модулей (лицо/тело) ожидается уменьшение множителя потоков на 25%. В этом случае объем ОЗУ = 1 ГБ + 0,75 ГБ x число видеопотоков.
• HDD: 3 ГБ свободного места.