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

Раздел «Источники»#

Раздел «Источники» предназначен для работы с потоками для анализа лиц и/или тел. Раздел содержит следующие элементы:

  • Группа — название группы, к которой прикреплён видеопоток;
  • Название — название источника;
  • Live — ссылка на трансляцию в реальном времени;
  • Статус источника (например, «В процессе», «Сбой» и т. д.);
  • Тип подключённой аналитики (лица и/или тела);
  • Локация — карта с отображением геометки камеры;
  • ID источника — скопируйте для поиска потоков по ID в фильтрах;
  • Логи — журналы аналитики источника;
  • кнопка «Добавить», которая открывает окно для создания потока;
  • фильтры для поиска потоков. Нажмите кнопку и отфильтруйте потоки по статусу, названию видеопотока и группе.
Раздел «Источники»
Раздел «Источники»

Создание и настройка группы#

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

Для создания группы:

1. Откройте область управления группами в разделе "Источники". 2. Нажмите кнопку "Добавить". 3. Укажите название группы, подразделение, тег доступа и сценарий. 4. Сохраните группу.

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

Создание потока#

Для добавления потока:

1. Нажмите кнопку «Добавить». 2. Выберите группу, в которую будет входить поток. 3. Настройте поток для оценки событий с лицами и/или телами (Таблица 31). 4. Сохраните созданный поток.

Поток может использовать только сценарий, принадлежащий тому же подразделению, что и группа потока.

Параметры создания потока
Параметры создания потока

Таблица 31. Основные параметры создания потока

Параметр

Описание

Основные параметры аналитики

Режим ВА

Выбор режима: Лица, Тела или Лица+Тела (значение по умолчанию).

ID обработчика для лучших кадров

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

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

Например: aaba1111-2111-4111-a7a7-5caf86621b5a

Обработка кадров

Параметр используется только для типов TCP, UDP и Видеофайл. Возможные значения:

  • Автоматический (значение по умолчанию);

  • Полный кадр;

  • Масштабируемый кадр.

Параметр задаётся для конкретного экземпляра FaceStream.

При значении "Полный кадр" кадр сразу конвертируется в RGB изображение необходимого размера после декодирования. При этом получается изображение лучшего качества, снижается скорость обработки кадров.

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

По умолчанию задано значение "Автоматический". В этом случае один из двух режимов выбирается автоматически

Количество потоков для декодирования видео

Задает количество потоков для декодирования видео с помощью FFMPEG. При увеличении числа потоков увеличивается число ядер процессора, задействованных в декодировании. Увеличение числа потоков рекомендуется при обработке видео высокого разрешения (4K и выше)

По умолчанию: 0

Максимальный FPS для обработки видео

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

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

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

Параметр не используется, если выставлено значение 0

По умолчанию: 0

Ширина кадра

Параметр используется только для типов TCP и UDP и предназначен для работы с протоколами, в которых подразумевается наличие нескольких каналов с разными битрейтами и разрешением (например, HLS).

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

По умолчанию: 800

Координаты ROI

Ограниченная область кадра, в которой происходит детекция и сопровождение лица или тела (например, при плотном потоке людей). Укажите значение ROI в одном их двух форматов – px или %.

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

Вторые два значения указывают ширину и высоту зоны интереса – если значения заданы в px, и ширину и высоту зоны относительно текущего размера кадра, если значения указаны в %. Например: 0,0,1920,1080 px или 0,0,100,100 %

Настройку параметра можно выполнить визуально на изображении кадра при редактировании потока. Для этого нажмите на иконку шестеренки. В открывшемся окне захватите границу зоны детекции и переместите её. Ширина, высота и координаты зоны детекции примут новые значения. Если детектировать нужно на всей области кадра, нажмите кнопку "Полный кадр". Сохраните изменения.

Координаты DROI

Ограниченная область внутри зоны ROI. Детектирование лиц выполняется в области ROI, но лучший кадр выбирается только в зоне DROI. Детекция лица должна полностью находиться внутри зоны DROI, чтобы кадр рассматривался в качестве лучшего. Укажите значение DROI в одном их двух форматов – px или %.

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

Вторые два значения указывают ширину и высоту зоны интереса – если значения заданы в px, и ширину и высоту зоны относительно текущего размера кадра, если значения указаны в %. Например:

0,0,1920,1080 px или 0,0,100,100 %

DROI рекомендуется использовать при работе со СКУД.

Параметр используется только для работы с лицами

Настройку параметра можно выполнить визуально на изображении кадра при редактировании потока. Для этого нажмите на иконку шестеренки. В открывшемся окне захватите границу зоны выбора лучшего кадра и переместите её. Ширина, высота и координаты зоны примут новые значения. Если выбирать лучший кадр нужно на всей области кадра, нажмите кнопку "Полный кадр". Сохраните изменения.

Параметры отправки изображений

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

Тип отправки изображений лучших кадров лиц и тел

Определяет тип отправляемых лучших кадров: лица, тела, лица+тела или раздельная отправка лица и тела.

Количество кадров лица/тела, отправляемых в рамках трека

Предполагает создание коллекции из лучших снимков трека или временного отрезка трека, заданного в параметре "Период анализа кадров, по истечении которого будет отправлен лучший кадр".

Эта коллекция будет отправлена в LP5.

Увеличение значения повышает вероятность правильного распознавания объекта, но сказывается на загруженности сети.

Возможные значения от 1 и больше. По умолчанию: 1.

Отправлять только полный набор данных тела

Позволяет посылать данные (лучшие снимки и детекции) только если имеется необходимое количество лучших снимков ("Количество кадров, которое пользователь хочет получить из трека или какого-то промежутка времени на этом треке") и длина трека ("Минимальный размер детекции для главного трека")

По умолчанию: Включено

Удалять данные о лучших снимках и детекциях тела после отправки

Позволяет удалять лучшие кадры и детекции после отправки данных. Если выключен, данные остаются в памяти

По умолчанию: Включено

Тип отправки изображений полного кадра события

Определяет тип отправки полного кадра события (лица, тела, лица+тела или раздельно).

Период анализа кадров, по истечении которого будет отправлен лучший кадр

Период начинается с момента появления человека в кадре — первой детекции. `

Уменьшение этого параметра позволяет быстрее определять личность, но с большей погрешностью.

Возможные значения:

  • количество кадров;

  • количество секунд;

  • -1 — анализ кадров проводится по всем кадрам до конца трека. По окончании трека (когда объект покидает пределы кадра) лучший кадр будет отправлен в LP5 (значение по умолчанию).

Период ожидания, когда предыдущий анализ кадров завершился, а новый еще не начался

Определяет время ожидания между двумя последовательными треками. `

Возможные значения:

  • количество кадров;

  • количество секунд;

  • 0 — время ожидания отсутствует;

  • -1 — период ожидания будет длиться бесконечно

Тип измерения периода анализа кадров и периода ожидания

Задает тип измерения периода анализа кадров и периода ожидания:

  • Секунды (значение по умолчанию);

  • Кадры

Выбор зависит от бизнес-задачи

Параметры фильтрации

Группа параметров описывает объекты фильтрации изображений и отправки результирующих лучших кадров

Порог для фильтрации отправляемых детекций лица/тела

Также именуемый Approximate Garbage Score (AGS) для лиц и Detector score для тел — порог для фильтрации детекций лиц и тел, отправляемых на сервер.

Все детекции с оценкой выше значения параметра могут быть отправлены на сервер в виде HTTP-запроса, иначе детекции не считаются приемлемыми для дальнейшей работы с ними.

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

По умолчанию: 0,5

Пороговое значение угла наклона вверх/вниз (pitch)

Максимальное значение угла наклона головы вверх и вниз ` относительно источника потока.

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

Данный параметр используется только для работы с лицами

По умолчанию: 40

Пороговое значение угла наклона влево/вправо (roll)

Максимальное значение угла наклона головы влево и вправо относительно источника потока.

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

Данный параметр используется только для работы с лицами

По умолчанию: 30

Пороговое значение угла поворота головы влево/вправо (yaw)

Максимальное значение угла поворота головы влево и вправо относительно источника потока (в градусах).

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

Данный параметр используется только для работы с лицами

По умолчанию: 40

Анализировать несколько кадров по углу поворота головы

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

По умолчанию: Выключен

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

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

Данный параметр используется только для работы с лицами.

По умолчанию: 1

Пороговое значение степени перекрытия рта

Если полученное значение превышает указанный порог, изображение считается неприемлемым для дальнейшей обработки. Например, при значении параметра равном 0,5 допускается перекрытие 50% области рта. Данный параметр используется только для работы с лицами

По умолчанию: 0

Минимальный размер тела для детекции (в пикселях)

Параметр задает размер детекции тела, меньше которого она не будет отправлена на обработку. Если значение равно 0, то фильтрация детекции тела по размеру выполняться не будет

По умолчанию: 0

Параметры Liveness

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

Коэффициент влияния Liveness (Masks, FlyingFaces)

Коэффициент влияния проверки каждого типа Liveness на итоговую оценку наличия живого человека в кадре.

Указываются две величины, относящиеся к разным типам Liveness. Величины указываются в долях единицы. Рекомендуемые значения: 0,5; 0,5.

Соотношение масштабируется исходя из данных цифр, вне зависимости от того, составляют ли они в сумме единицу и какие из методов Liveness включены

Выполнять проверку MasksД Liveness

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

Если при включенном параметре скорость обработки падает, необходимо уменьшить разрешение видео в настройках источника потока

Выполнять проверку Masks, FlyingFaces Liveness

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

Если при включенном параметре скорость обработки падает, необходимо уменьшить разрешение видео в настройках источника потока

Для каких кадров трека будет проводиться проверка Liveness

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

Варианты выбора кадров:

  • Первые N кадров (значение по умолчанию);

  • Последние N кадров перед отправкой лучшего кадра;

  • Все кадры трека.

Значение "N" указывается в параметре "Количество кадров в треке для проверки Liveness при использовании параметра liveness-mode"

Количество кадров в треке для проверки Liveness

Количество кадров в треке для проверки Liveness при использовании параметра "Для каких кадров трека будет проводиться проверка Liveness"

По умолчанию: 0

Пороговое значение, при котором система будет считать, что в кадре живой человек

Решение Сервиса о присутствии в кадре настоящего человека последует, только если Liveness вернет значение выше заданного порогового значения.

Возможные значения от 0 до 1. Не рекомендуется выбирать значение ниже0.6

По умолчанию: 0

Количество кадров заднего фона, используемое при проверке Mask Liveness

Позволяет задать количество кадров фона в треке для проверки Liveness.

Рекомендуемое значение: 300.

Не рекомендуется изменять данный параметр

По умолчанию: 0

Параметры проверки состояния потока

Данная группа параметров используется только при работе с потоками (TCP, UDP) и видеофайлами.

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

Максимальное количество ошибок, после которого поток перейдет в статус «Ошибка»

Максимальное количество ошибок при воспроизведении потока.

(в секундах)" и "Время, по истечении которого выполняется повторная попытка подключения к видеопотоку (в секундах)".

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

Если за время, указанное в параметре "Время, за которое ведется подсчет ошибок (в секундах)", было накоплено количество ошибок большее или равное количеству, указанному в параметре, то обработка потока . будет прекращена и его статус изменится на "Сбой"

Ошибки могут быть вызваны проблемой с сетью или доступностью видео

По умолчанию: 10

Время, за которое ведется подсчет ошибок (в секундах)

Параметр-критерий времени повторного подключения к видеопотоку. Если за указанное время зафиксировано количество ошибок, равное указанному в параметре максимального количества, выполняется попытка повторного подключения к видеопотоку

По умолчанию: 3600

Использовать Primary Track

Данная группа параметров предназначена для работы с системами контроля управления доступом (СКУД, турникеты на входах) для упрощения контроля и внедрения технологии распознавания лиц при входе на охраняемую территорию.

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

Данная группа параметров не используется для типа "Изображения"

Использовать Primary Track

Если значение этого параметра Включено, то включается режим реализации Главного Трека (Primary Track).

Из всех детекций на кадре выбирается максимальная по размеру детекция и её трек становится главным. На основе этого трека выполняется дальнейший анализ.

Лучший кадр из этого трека отправляется в LP5.

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

По умолчанию: Выключено

Минимальный размер детекции для главного трека

Задает минимальный размер детекции (в пикселях по вертикали), при котором начинается анализ кадров потока и определение лучшего кадра

По умолчанию: 70

Размер детекции для главного трека

Задаёт размер детекции в пикселях для Главного Трека. `

Когда размер детекции достигает указанного значения, трек сразу отправляет все свои лучшие снимки в LP5

По умолчанию: 140