Раздел «Источники»#
Раздел «Источники» предназначен для работы с потоками для анализа лиц и/или тел. Раздел содержит следующие элементы:
- Группа — название группы, к которой прикреплён видеопоток;
- Название — название источника;
- Live — ссылка на трансляцию в реальном времени;
- Статус источника (например, «В процессе», «Сбой» и т. д.);
- Тип подключённой аналитики (лица и/или тела);
- Локация — карта с отображением геометки камеры;
- ID источника — скопируйте для поиска потоков по ID в фильтрах;
- Логи — журналы аналитики источника;
- кнопка «Добавить», которая открывает окно для создания потока;
- фильтры для поиска потоков. Нажмите кнопку и отфильтруйте потоки по статусу, названию видеопотока и группе.
Создание и настройка группы#
Перед созданием потока создайте или выберите группу источников, в которую будет входить поток. Группа принадлежит подразделению и может использовать только сценарий, принадлежащий тому же подразделению. Сценарий, назначенный группе, наследуется потоками, создаваемыми в этой группе, если для потока не задан индивидуальный сценарий.
Для создания группы:
1. Откройте область управления группами в разделе "Источники". 2. Нажмите кнопку "Добавить". 3. Укажите название группы, подразделение, тег доступа и сценарий. 4. Сохраните группу.
Если одновременно заданы настройки сценария на уровне группы и на уровне потока, индивидуальные настройки потока имеют приоритет над настройками группы.
Создание потока#
Для добавления потока:
1. Нажмите кнопку «Добавить». 2. Выберите группу, в которую будет входить поток. 3. Настройте поток для оценки событий с лицами и/или телами (Таблица 31). 4. Сохраните созданный поток.
Поток может использовать только сценарий, принадлежащий тому же подразделению, что и группа потока.
Таблица 31. Основные параметры создания потока
|
Параметр |
Описание |
|---|---|
|
Основные параметры аналитики |
|
|
Режим ВА |
Выбор режима: Лица, Тела или Лица+Тела (значение по умолчанию). |
|
ID обработчика для лучших кадров |
Параметр позволяет использовать внешний статический При использовании данного сценария LP5 генерирует событие, которое содержит всю информацию, полученную из FaceStream и обрабатывает её в соответствии с правилами обработки. Например: |
|
Обработка кадров |
Параметр используется только для типов TCP, UDP и Видеофайл. Возможные значения:
Параметр задаётся для конкретного экземпляра FaceStream. При значении "Полный кадр" кадр сразу конвертируется в RGB изображение необходимого размера после декодирования. При этом получается изображение лучшего качества, снижается скорость обработки кадров. При значении "Масштабируемый кадр" масштабирование изображения выполняется в зависимости от настроек TrackeEgine. По умолчанию задано значение "Автоматический". В этом случае один из двух режимов выбирается автоматически |
|
Количество потоков для декодирования видео |
Задает количество потоков для декодирования видео с помощью FFMPEG. При увеличении числа потоков увеличивается число ядер процессора, задействованных в декодировании. Увеличение числа потоков рекомендуется при обработке видео высокого разрешения (4K и выше) По умолчанию: |
|
Максимальный FPS для обработки видео |
Параметр используется только для типа Видеофайл. Видео обрабатывается с заданным количеством FPS. Видео не может быть обработано с FPS выше, чем указано в данном параметре. Если у видео высокое значение FPS, и FaceStream не может работать с заданным количеством кадров в секунду, то кадры будут пропускаться. Таким образом, видеофайл имитирует поток с реальной видеокамеры. Это может быть полезно при настройке производительности. Видео будет проигрываться с выбранной скоростью, что удобно для нагрузочного тестирования и последующего анализа. Параметр не используется, если выставлено значение По умолчанию: |
|
Ширина кадра |
Параметр используется только для типов TCP и UDP и предназначен для работы с протоколами, в которых подразумевается наличие нескольких каналов с разными битрейтами и разрешением (например, HLS). Если у потока существует несколько таких каналов, то данный параметр позволит выбрать из всех каналов цельного потока тот канал, ширина кадра которого ближе к значению, указанному в данном параметре. По умолчанию: |
|
Координаты ROI |
Ограниченная область кадра, в которой происходит детекция и сопровождение
лица или тела (например, при плотном потоке людей). Укажите значение ROI в
одном их двух форматов – Первые два значения будут задавать координаты верхней левой точки кадра. Вторые два значения указывают ширину и высоту зоны интереса – если значения
заданы в Настройку параметра можно выполнить визуально на изображении кадра при редактировании потока. Для этого нажмите на иконку шестеренки. В открывшемся окне захватите границу зоны детекции и переместите её. Ширина, высота и координаты зоны детекции примут новые значения. Если детектировать нужно на всей области кадра, нажмите кнопку "Полный кадр". Сохраните изменения. |
|
Координаты DROI |
Ограниченная область внутри зоны ROI. Детектирование лиц выполняется
в области ROI, но лучший кадр выбирается только в зоне DROI. Детекция лица должна полностью
находиться внутри зоны DROI, чтобы кадр рассматривался в качестве лучшего. Укажите значение
DROI в одном их двух форматов – Первые два значения будут задавать координаты верхней левой точки кадра. Вторые два значения указывают ширину и высоту зоны интереса – если значения заданы в
DROI рекомендуется использовать при работе со СКУД. Параметр используется только для работы с лицами Настройку параметра можно выполнить визуально на изображении кадра при редактировании потока. Для этого нажмите на иконку шестеренки. В открывшемся окне захватите границу зоны выбора лучшего кадра и переместите её. Ширина, высота и координаты зоны примут новые значения. Если выбирать лучший кадр нужно на всей области кадра, нажмите кнопку "Полный кадр". Сохраните изменения. |
|
Параметры отправки изображений |
В данной группе параметров определяется период, в течение которого будет проводиться анализ кадров для выбора лучшего кадра, а также определяются все параметры, связанные с составлением коллекции лучших кадров |
|
Тип отправки изображений лучших кадров лиц и тел |
Определяет тип отправляемых лучших кадров: лица, тела, лица+тела или раздельная отправка лица и тела. |
|
Количество кадров лица/тела, отправляемых в рамках трека |
Предполагает создание коллекции из лучших снимков трека или временного отрезка трека, заданного в параметре "Период анализа кадров, по истечении которого будет отправлен лучший кадр". Эта коллекция будет отправлена в LP5. Увеличение значения повышает вероятность правильного распознавания объекта, но сказывается на загруженности сети. Возможные значения от 1 и больше. По умолчанию: |
|
Отправлять только полный набор данных тела |
Позволяет посылать данные (лучшие снимки и детекции) только если имеется необходимое количество лучших снимков ("Количество кадров, которое пользователь хочет получить из трека или какого-то промежутка времени на этом треке") и длина трека ("Минимальный размер детекции для главного трека") По умолчанию: Включено |
|
Удалять данные о лучших снимках и детекциях тела после отправки |
Позволяет удалять лучшие кадры и детекции после отправки данных. Если выключен, данные остаются в памяти По умолчанию: Включено |
|
Тип отправки изображений полного кадра события |
Определяет тип отправки полного кадра события (лица, тела, лица+тела или раздельно). |
|
Период анализа кадров, по истечении которого будет отправлен лучший кадр |
Период начинается с момента появления человека в кадре — первой детекции. ` Уменьшение этого параметра позволяет быстрее определять личность, но с большей погрешностью. Возможные значения:
|
|
Период ожидания, когда предыдущий анализ кадров завершился, а новый еще не начался |
Определяет время ожидания между двумя последовательными треками. ` Возможные значения:
|
|
Тип измерения периода анализа кадров и периода ожидания |
Задает тип измерения периода анализа кадров и периода ожидания:
Выбор зависит от бизнес-задачи |
|
Параметры фильтрации |
Группа параметров описывает объекты фильтрации изображений и отправки результирующих лучших кадров |
|
Порог для фильтрации отправляемых детекций лица/тела |
Также именуемый Approximate Garbage Score (AGS) для лиц и Detector score для тел — порог для фильтрации детекций лиц и тел, отправляемых на сервер. Все детекции с оценкой выше значения параметра могут быть отправлены на сервер в виде HTTP-запроса, иначе детекции не считаются приемлемыми для дальнейшей работы с ними. Рекомендуемое значение порога было выявлено путем проведения исследований и анализа детекций на различных изображениях лиц и тел По умолчанию: |
|
Пороговое значение угла наклона вверх/вниз (pitch) |
Максимальное значение угла наклона головы вверх и вниз ` относительно источника потока. Если угол наклона головы на кадре больше заданного значения, то кадр считается неприемлемым для дальнейшей обработки. Данный параметр используется только для работы с лицами По умолчанию: |
|
Пороговое значение угла наклона влево/вправо (roll) |
Максимальное значение угла наклона головы влево и вправо относительно источника потока. Если угол наклона головы на кадре больше заданного значения, то кадр считается неприемлемым для дальнейшей обработки. Данный параметр используется только для работы с лицами По умолчанию: |
|
Пороговое значение угла поворота головы влево/вправо (yaw) |
Максимальное значение угла поворота головы влево и вправо относительно источника потока (в градусах). Если угол поворота головы на кадре больше заданного значения, кадр считается неприемлемым для дальнейшей обработки. Данный параметр используется только для работы с лицами По умолчанию: |
|
Анализировать несколько кадров по углу поворота головы |
Включить функцию анализа, которая позволяет отсекать изображения с сильно повернутыми от источника потока лицами. По умолчанию: Выключен |
|
Количество кадров, используемых для фильтрации фотоизображений по углу поворота головы |
Указывается количество кадров для анализа углов поворота головы на каждом из этих кадров. Если угол резко отличается от среднего значения в группе, кадр не будет рассматриваться в качестве лучшего кадра. Данный параметр используется только для работы с лицами. По умолчанию: |
|
Пороговое значение степени перекрытия рта |
Если полученное значение превышает указанный порог, изображение считается неприемлемым для дальнейшей обработки. Например, при значении параметра равном 0,5 допускается перекрытие 50% области рта. Данный параметр используется только для работы с лицами По умолчанию: |
|
Минимальный размер тела для детекции (в пикселях) |
Параметр задает размер детекции тела, меньше которого она не будет отправлена на обработку. Если значение равно 0, то фильтрация детекции тела по размеру выполняться не будет По умолчанию: |
|
Параметры Liveness |
Liveness используется для проверки наличия живого человека в кадре и предотвращает использование распечатанного фото или фото с телефона для прохождения проверки. Данная группа параметров используется только для работы с лицами. Данная группа параметров не используется для типа "Изображения" |
|
Коэффициент влияния Liveness (Masks, FlyingFaces) |
Коэффициент влияния проверки каждого типа Liveness на итоговую оценку наличия живого человека в кадре. Указываются две величины, относящиеся к разным типам Liveness. Величины указываются в долях единицы. Рекомендуемые значения: Соотношение масштабируется исходя из данных цифр, вне зависимости от того, составляют ли они в сумме единицу и какие из методов Liveness включены |
|
Выполнять проверку MasksД Liveness |
Включает режим проверки наличия человека в кадре, основанный на работе с фоном. Скорость выполнения проверки зависит от размера кадров видеопотока. Если при включенном параметре скорость обработки падает, необходимо уменьшить разрешение видео в настройках источника потока |
|
Выполнять проверку Masks, FlyingFaces Liveness |
Включает режим проверки наличия человека в кадре, основанный на работе с фоном и окружением лица Скорость выполнения проверки зависит от размера кадров видеопотока. Если при включенном параметре скорость обработки падает, необходимо уменьшить разрешение видео в настройках источника потока |
|
Для каких кадров трека будет проводиться проверка Liveness |
Параметр указывает, для каких кадров трека будет проводиться проверка Liveness. Варианты выбора кадров:
Значение "N" указывается в параметре "Количество кадров в треке для проверки Liveness при использовании параметра liveness-mode" |
|
Количество кадров в треке для проверки Liveness |
Количество кадров в треке для проверки Liveness при использовании параметра "Для каких кадров трека будет проводиться проверка Liveness" По умолчанию: |
|
Пороговое значение, при котором система будет считать, что в кадре живой человек |
Решение Сервиса о присутствии в кадре настоящего человека последует, только если Liveness вернет значение выше заданного порогового значения. Возможные значения от По умолчанию: |
|
Количество кадров заднего фона, используемое при проверке Mask Liveness |
Позволяет задать количество кадров фона в треке для проверки Liveness. Рекомендуемое значение: Не рекомендуется изменять данный параметр По умолчанию: |
|
Параметры проверки состояния потока |
Данная группа параметров используется только при работе с потоками (TCP, UDP) и видеофайлами. В данной группе можно задать параметры повторного подключения к потоку при возникновении ошибок проигрывания потока |
|
Максимальное количество ошибок, после которого поток перейдет в статус «Ошибка» |
Максимальное количество ошибок при воспроизведении потока. (в секундах)" и "Время, по истечении которого выполняется повторная попытка подключения к видеопотоку (в секундах)". После получения первой ошибки выполняется ожидание, заданное в параметре "Время, по истечении которого выполняется повторная попытка подключения к видеопотоку (в секундах)", а затем выполняется повторная попытка подключения к потоку. Если за время, указанное в параметре "Время, за которое ведется подсчет ошибок (в секундах)", было накоплено количество ошибок большее или равное количеству, указанному в параметре, то обработка потока . будет прекращена и его статус изменится на "Сбой" Ошибки могут быть вызваны проблемой с сетью или доступностью видео По умолчанию: |
|
Время, за которое ведется подсчет ошибок (в секундах) |
Параметр-критерий времени повторного подключения к видеопотоку. Если за указанное время зафиксировано количество ошибок, равное указанному в параметре максимального количества, выполняется попытка повторного подключения к видеопотоку По умолчанию: |
|
Использовать Primary Track |
Данная группа параметров предназначена для работы с системами контроля управления доступом (СКУД, турникеты на входах) для упрощения контроля и внедрения технологии распознавания лиц при входе на охраняемую территорию. Данная группа параметров используется только для работы с лицами. Данная группа параметров не используется для типа "Изображения" |
|
Использовать Primary Track |
Если значение этого параметра Включено, то включается режим реализации Главного Трека (Primary Track). Из всех детекций на кадре выбирается максимальная по размеру детекция и её трек становится главным. На основе этого трека выполняется дальнейший анализ. Лучший кадр из этого трека отправляется в LP5. При использовании параметра на контрольно-пропускном пункте будут отправляться лучшие снимки только того человека, который находится ближе всего к турникету (выполняется условие возникновения самой большой детекции) Ошибки могут быть вызваны проблемой с сетью или доступностью видео По умолчанию: Выключено |
|
Минимальный размер детекции для главного трека |
Задает минимальный размер детекции (в пикселях по вертикали), при котором начинается анализ кадров потока и определение лучшего кадра По умолчанию: |
|
Размер детекции для главного трека |
Задаёт размер детекции в пикселях для Главного Трека. ` Когда размер детекции достигает указанного значения, трек сразу отправляет все свои лучшие снимки в LP5 По умолчанию: |