Перейти к содержанию

LUNA PLATFORM v.5.34.0#

Изменения

  • SDK обновлен до версии 5.12.0. Основные изменения SDK, затрагивающие LUNA PLATFORM:

    • обновлены следующие эстиматоры: LivenessOneShotRGB, FishEye, Orientation, HeadWear;
    • удалены 54-ая, 56-ая и 57-ая модели нейронных сетей извлечения биометрических шаблонов лиц и 104-ая и 106-ая модели нейронных сетей извлечения биометрических шаблонов тел. Поддержка данных моделей остается доступной. При необходимости можно запросить их у специалистов VisionLabs.

    Теперь модель нейронной сети извлечения биометрических шаблонов тел по умолчанию — 107 (настройка "DEFAULT_HUMAN_DESCRIPTOR_VERSION" сервиса Handlers).

    Важная информация по обновлению с предыдущих версий

    Необходимо выполнить одно из следующих действий перед запуском контейнера Handlers:

    • вручную изменить значение настройки "DEFAULT_HUMAN_DESCRIPTOR_VERSION" с "104" или "106" на "107". После изменения версии нейронной сети извлечения биометрических шаблонов тел необходимо выполнить задачу "Additional extraction" после запуска сервиса Admin (см. раздел "Launch re-extraction task" в руководстве администратора). В противном случае, поиск и сравнение по старым биометрическим шаблонам будут недоступны.
    • выключить использование нейронной сети для извлечения биометрического шаблона тела с помощью передачи аргумента --enable-body-descriptor-estimator=0 при старте контейнера Handlers
    • запросить у VisionLabs 104-ую модель нейронной сети и перенести её в контейнер Handlers по инструкции, описанной в разделе "Use non-delivery neural network model" руководства администратора

    Если не выполнить одно из вышеописанных действий, то запуск сервис Handlers завершится ошибкой.

    Вся вышеописанная информация добавлена в руководство по обновлению в раздел "Changing the model of the neural network of bodies".

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

  • В структуру события добавлено новое поле "meta", предназначенное для хранения произвольных пользовательских данных в JSON-формате (не более 2 Мб).

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

    { "struct1": { ... }, "struct2": { ... } }

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

    • в теле запроса "generate events" с типом содержимого application/json или multipart/form-data;
    • в теле запроса "save event";
    • с помощью пользовательского плагина или клиентского приложения.

    В теле запроса "generate events" доступна возможность задать поле "meta" как для конкретных изображений, так и для всех изображений сразу (взаимная метаинформация). Для запросов с включенной агрегацией для агрегированного события будет использоваться только взаимная метаинформация, а метаинформация для конкретных изображений будет игнорироваться. См. подробную информацию в теле запроса "generate events" в спецификации OpenAPI.

    Поле "meta" может быть использовано как фильтр в запросе "get events" или в качестве значения для параметра "target" в запросе "get event".

    Колонка "meta" добавлена в задачи Reporter и Exporter.

    Поддержка метаинформации события также добавлена в ресурс "ws handshake".

    При необходимости можно построить индекс для улучшения поиска.

    См. подробное описание и особенности работы в разделе "Events meta-information" руководства администратора.

  • Прекращена поддержка сервиса Liveness V1.

    Сервис Liveness V1 удален из документации и настроек сервисов. Liveness V2 переименован в Liveness.

  • В аргументы запуска контейнера Handlers добавлен новый аргумент enable-all-estimators-by-default, включающий/отключающий инициализацию всех эстиматоров и детекторов по умолчанию.

    Ранее для использования определенных эстиматоров или детекторов приходилось указывать статус каждого эстиматора из всех существующих. Теперь достаточно отключить инициализацию всех эстиматоров enable-all-estimators-by-default=0 по умолчанию, а затем указать только те эстиматоры или детекторы, которые необходимо включить.

    Пример команды запуска сервиса Handlers с использованием только детектора лиц и эстиматоров биометрического образца лица и эмоций.

    docker run \ ... --env=EXTEND_CMD="--enable-all-estimators-by-default=0 --enable-face-detector=1 --enable-face-warp-estimator=1 --enable-emotions-estimator=1" \ ...

    См. подробную информацию в разделе "Enable/disable several estimators and detectors" руководства администратора.

  • Теперь фильтр по "account_id" не является обязательным для задач Clustering (фильтр в теле запроса), Cross-matching (фильтра в теле запроса для кандидатов или эталона) и Estimator (фильтры сравнения в политиках обработчика). Это позволяет выполнять сравнение по объектам разных аккаунтов.

  • Для нижеперечисленных ресурсов в тело ответа добавлен новый параметр "external_url", указывающий абсолютный адрес до объекта:

    В качестве абсолютного адреса используется адрес сервиса API, указанный в настройке "EXTERNAL_LUNA_API_ADDRESS" сервиса API. Значение настройки по умолчанию — http://127.0.0.1:5000/6/.

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

    Пример относительной ссылки (параметр "url"): "/6/objects/4a870804-0cd6-4c13-9c78-98ad167dc4ec"

    Пример абсолютной ссылки (параметр "external_url"): "http://127.0.0.1:5000/6/objects/4a870804-0cd6-4c13-9c78-98ad167dc4ec"

  • В ресурс пакетной выгрузки биометрических шаблонов "get face descriptor batches" сервиса Faces добавлена поддержка заголовка "Accept", принимающего два значения — application/x-flutbuf (по умолчанию) и application/x-msgpack.

  • Из настроек сервиса Handlers удален неиспользуемый параметр "max_face_size" из секции "LUNA_HANDLERS_FACE_DETECTOR_SETTINGS".

    Параметр "max_face_size" рассчитывается как min_face_size * 32.

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

  • В спецификации OpenAPI сервиса API исправлены и дополнены примеры ответов с кодами 403, 408, 413, 500, 503 и 504. См. примеры ответов в спецификации OpenAPI.

  • В запрос "perform verification" добавлен отсутствующий ранее параметр указания типа обрабатываемого изображения "image_type". Для данного параметра доступно два значения — 0 (исходное изображение) и 1 (биометрический образец лица).

  • Исправлены некорректные пороги для параметров "mouth_occluded", "mouth_smiling" и "mouth_open" группы параметров "face_quality" в запросах "create handler", "get handlers", "get handler" и "replace handler" в спецификациях OpenAPI сервисов API и Handlers.

    В спецификации было указано, что допустимые пороги для вышеперечисленных параметров равны [-1..1], хотя на самом деле допустимые пороги равны [0..1].