LUNA PLATFORM v.5.84.0#

Изменения LP

SDK обновлен до версии 5.23.0.
- Эстиматор Deepfake обновлён до версии 5;
- Эстиматор OneShotLiveness обновлён до версии 8;
- Удалена поддержка 52-ой версии нейронной сети биометрического шаблона лиц;
- Из комплекта поставки удалена 110-ая версия нейронной сети дескрипторов тел. Теперь по умолчанию используется 116-ая для извлечения биометрических шаблонов тел (настройка "DEFAULT_HUMAN_DESCRIPTOR_VERSION" сервиса Remote SDK).
Важно! Если на момент обновления используется 110-ая модель нейронной сети (настройка "DEFAULT_HUMAN_DESCRIPTOR_VERSION"), то без дополнительных действий сервис Remote SDK не запустится.

Необходимо выполнить одно из дополнительных действий ниже:
- Запросить отсутствующую модель у VisionLabs и самостоятельно добавить в контейнер Remote SDK.
- Выполнить задачу "Additional extraction" перед началом обновления, а затем указать новую версию в настройке "DEFAULT_HUMAN_DESCRIPTOR_VERSION" перед запуском сервиса Remote SDK, тем самым сохранив возможность использования старых биометрических шаблонов.
- Указать новую версию в настройке "DEFAULT_HUMAN_DESCRIPTOR_VERSION" перед запуском сервиса Remote SDK. Эта настройка не будет автоматически обновлена при выполнении миграции. Если не будет выполнена "Additional extraction", то использовать уже существующие биометрические шаблоны будет невозможно.
Добавлен новый эстиматор проверки лиц - "Face Occlusion", который позволяет автоматически определять наличие перекрытия зон лица.

Эстиматор позволяет определить наличие перекрытия всего лица или его отдельных зон.

Эстиматор возвращает информацию о перекрытии:
- Всего лица
- Зоны лба
- Зоны глаз
- Зоны носа
- Зоны рта
- Нижней части лица
Ресурсы, в которых выполняется оценка:
- "/handlers"
  
  Название оценки — "estimate_face_occlusion".
- "/verifiers"
  
  Название оценки — "estimate_face_occlusion".
Пороги перекрытия

Возможно задать допустимый процент перекрытия всего лица или каждой отдельной части лица на уровне всей системы в Configurator. Кроме того, пороги можно переопределить при создании обработчика или верификатора.

Возможно задать порог для перекрытия волосами. Порог указывает допустимый процент перекрытия волосами, при котором волосы не учитываются в качестве перекрытия. Всё перекрытие, которое превышает указанный порог, учитывается в общем перекрытии лица и перекрытии каждой из зон лица.
- Если порог перекрытия волосами задан равным 0, то волосы любой длины будут считаться перекрытием.
- Если порог перекрытия волосами задан равным 1, то перекрытие волосами не учитывается.
Пороги могут быть изменены в соответствии с бизнес задачами.

Примечание. Зона усов и бороды никогда не считаются перекрытием лица.

Фильтрация

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

Детекция фильтруется, если перекрытие любой из указанных зон превышает порог. Дальнейшая обработка детекции не выполняется и в ответе возвращается причина фильтрации.
В сервис Video Agent добавлена поддержка видеоаналитики трекинга людей.

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

Для трекинга людей используется фильтрация по AGS и положению головы.
В сервис Configurator добавлена возможность использования авторизации типа BasicAuth для запросов, логически требущих авторизации.

Примечание. Данный функционал находится в стадии бета-тестирования.

Для включения авторизации нужно задать следующие настройки из новой секции "LUNA_CONFIGURATOR_AUTHORIZATION" сервиса Configurator:
- "USE_AUTHORIZATION" - включение/выключение авторизации
- "LUNA_CONFIGURATOR_USER" - логин, который будет использоваться другими сервисами для авторизации
- "LUNA_CONFIGURATOR_PASS" - пароль, который будет использоваться другими сервисами для авторизации
Задать настройки можно двумя способами:
- передача настроек через переменную окружения VL_SETTINGS при старте сервиса. Например:
env "VL_SETTINGS.LUNA_CONFIGURATOR.USE_AUTHORIZATION=1" env "VL_SETTINGS.LUNA_CONFIGURATOR.LUNA_CONFIGURATOR_USER=luna" env "VL_SETTINGS.LUNA_CONFIGURATOR.LUNA_CONFIGURATOR_PASS=root"
- передача настроек в конфигурационный файл сервиса Configurator. Конфигурационный файл сервиса Configurator расположен по следующему пути в поставке example-docker/luna_configurator/configs/luna_configurator_postgres.conf
Для того, чтобы остальные сервисы LUNA PLATFORM могли выполнять запросы к сервису Configurator нужно передать им логин и пароль. Это можно сделать с помощью следующих способов:
- передача настроек "LUNA_CONFIGURATOR_USER" и "LUNA_CONFIGURATOR" через переменную окружения VL_SETTINGS при старте сервиса (см. пример выше)
- передача настроек "LUNA_CONFIGURATOR_USER" и "LUNA_CONFIGURATOR" в конфигурационный файл сервиса
Использование авторизации позволяет обеспечить дополнительную степень безопасности и защиту от несанкционированного доступа. Для обеспечения шифрования необходимо использовать SSL-сертификаты или проксирование через Nginx.
В запрос videosdk для видеоаналитики отслеживания людей добавлен параметр rate, с помощью которого можно настроить частоту обработки кадров (например, обрабатывать каждые 3 секунды или каждые 3 кадра).

Значение параметраrate по умолчанию - 1 кадр.

Раньше данный параметр был доступен только для аналитики подсчета количества людей.
В сервис Remote SDK добавлена группа параметров LUNA_REMOTE_SDK_HUMAN_TRACKER_SETTINGS, которая позволяет настроить параметры TrackEngine.

Доступны следующие параметры:
- runtime_settings > device_class — задает тип устройства ("cpu", "gpu" или "global");
- runtime_settings > optimal_batch_size — задает размер батча;
- estimator_settings > detector_step - задает частоту детектирования лиц и тел на кадрах. На остальных кадрах выполняется редетекция;
- estimator_settings > scale_result_size - определяет, до какого размера (в пикселях) масштабируется кадр перед тем, как он будет отправлен на детекцию. Изображение масштабируется по максимальному измерению (ширина или высота);
- estimator_settings > skip_frames - определяет количество кадров, на протяжении которых система не завершает трек в ожидании повторного объекта. Если трек не был продлён ни детектором, ни редетекцией, трек завершается.
В запрос videosdk для видеоаналитики трекинга людей добавлена поддержка задания области интереса DROI относительно исходного кадра.

См. описание DROI в разделе "droi".
Запросы на кросс-матчинг с использованием сервиса Python Matcher Proxy были ускорены за счет реализации пакетной обработки.
Теперь в запросе videosdk для видеоаналитики трекинга людей биометрические шаблоны лиц фильтруются по AGS, а не по степени достоверности детекции (Detection score), что позволяет отсекать некачественные детекции.

Если эстиматор AGS недоступен, то будет использоваться фильтрация по степени достоверности детекции.
В запрос get platform features добавлен параметр video_analytics, позволяющий отслеживать состояние сервиса (включен/выключен).

Исправленные ошибки LP

В спецификацию OpenAPI сервиса API добавлен лимит на загружаемые лица для запроса "attach/detach faces to the list".
Исправлена ошибка, которая возникала при отправке запроса generate stream events из-за чего возникало несоответствие количества биометрических образцов числу переданных детекций.
Исправлена ошибка, из-за которой нельзя было создавать потоки с несколькими аналитиками одного типа, но с разными параметрами.
Исправлена ошибка, из-за которой сервис Video Manager некорректно обрабатывал потоки с несколькими аналитиками.
Исправлена ошибка в запросах generate stream events и generate events из-за которой создавалось новое лицо если детекция лица не была выполнена.
Исправлена ошибка при которой значения параметров "RESPONSE_TIMEOUT" групп "LUNA_MATCHER_PROXY_HTTP_SETTINGS" и "LUNA_PYTHON_MATCHER_HTTP_SETTINGS" не обновлялись должным образом и всегда применялось дефолтное значение в 600 секунд.