Эпизоды событий
Данный раздел посвящен вкладке Эпизоды.
См.также
Эпизод — это набор событий идентификации, в которых фигурируют объекты одного происхождения (изображения лица и силуэта одного и того же человека и изображения одного и того же транспортного средства), обнаруженные в течение определенного периода времени. Поскольку события на вкладке События отображаются в произвольном порядке, обработка большого количества разнородных событий может быть делом затруднительным и неэффективным. Функция эпизодов позволяет автоматически объединять входящие события на основе времени обнаружения и схожести объектов. Это позволяет с легкостью обрабатывать разнородные события даже в больших количествах.
В этой главе:
Об эпизодах
В жизненном цикле эпизода существует два этапа:
LIVE: открытый на данный момент эпизод, в который могут быть добавлены новые события.
Закрытый: закрытый эпизод, добавление событий невозможно.
Эпизоды классифицируются как эпизоды с людьми и эпизоды с транспортными средствами. Эпизоды с людьми содержат изображения лиц и силуэтов людей, обнаруженные в течение определенного периода времени, а эпизоды с транспортными средствами содержат изображения транспортного средства и регистрационного номера.
Назначение прав на эпизоды
Пользователь получает уведомление о новом эпизоде, если у него есть права на открывающее этот эпизод событие. Просмотр новых событий в эпизоде также требует соответствующих прав.
Право на событие состоит из прав на соответствующие камеру и список наблюдения.
Примечание
Для просмотра не сопоставленных с карточкой событий вам понадобятся только права на камеру.
Для управления правами на объект Эпизод
перейдите в разрешения для соответствующей роли и настройте следующие разрешения:
humanepisode
: эпизоды с людьмиcarepisode
: эпизоды с транспортными средствами
Совет
Просмотр эпизодов
Вы можете найти список эпизодов с фильтрами и статистикой на вкладке Эпизоды. Эпизоды сортируются по происхождению объекта: есть эпизоды с людьми и эпизоды с транспортными средствами.
Событие обнаружения объекта либо добавляется в существующий LIVE-эпизод, либо инициирует создание нового эпизода. Каждому эпизоду присваивается id, который впоследствии можно использовать для фильтрации событий и эпизодов.
К эпизодам в списке можно применить следующие фильтры:
Примечание
Некоторые фильтры из приведенного ниже списка могут быть скрыты, в зависимости от активированной функциональности распознавания.
Фильтры эпизодов для людей и ТС
Тип эпизода человека: отобразить только эпизоды с лицами или только эпизоды с силуэтами.
Совпадения: лица: отобразить только эпизоды с совпадением лиц/без совпадения лиц/все эпизоды.
Совпадения: силуэты: отобразить только эпизоды с совпадением силуэтов/без совпадения силуэтов/все эпизоды.
Совпадения: отобразить только эпизоды с совпадением транспортных средств/без совпадения транспортных средств/все эпизоды.
Списки наблюдения: отобразить только эпизоды по определенному списку наблюдения.
Подтверждено: отобразить только подтвержденные/неподтвержденные или все эпизоды.
Группы камер: отобразить только эпизоды по определенной группе камер.
Камеры: отобразить только эпизоды по определенной камере.
ID камер: отображать только эпизоды по камере с определенным ID.
Дата и время: отобразить только эпизоды, случившиеся в определенный период времени.
ID видеоархива: отобразить эпизоды из видеоархива с определенным ID.
Название карточки: отобразить эпизоды с заданным названием карточки.
ID эпизода: отобразить эпизод с определенным ID.
Количество событий: отобразить эпизоды с заданным количеством событий.
Специальные фильтры для эпизодов с лицами
Возраст: отобразить эпизоды с людьми определенного возраста.
Пол: отобразить эпизоды с людьми заданного пола.
Эмоции: отобразить эпизоды с заданными эмоциями.
Борода: фильтровать эпизоды по наличию бороды.
Состояние глаз: фильтровать события в зависимости от того, открыты глаза или закрыты, а также от того, перекрыты ли они каким-либо объектом.
Очки: фильтровать эпизоды по наличию очков на лице.
Медицинская маска: фильтровать эпизоды по наличию медицинской маски.
Поворот: фильтровать эпизоды по углу поворота головы.
Наклон: фильтровать эпизоды по углу наклона головы.
Витальность: фильтровать эпизоды по liveness лица (истинное лицо или изображение).
Специальные фильтры для эпизодов с силуэтами
Возраст по силуэту: отобразить эпизоды с людьми определенного возраста.
Пол по силуэту: отобразить эпизоды с людьми заданного пола.
Тип верха одежды: отобразить только те эпизоды, в которых человек носит одежду верха заданного типа: куртка, пальто, безрукавка, толстовка, футболка, рубашка, платье.
Верх одежды: отобразить только те эпизоды, в которых человек носит одежду верха заданной обобщенной категории: с длинными рукавами, с короткими рукавами, без рукавов.
Цвет верха одежды: отобразить только эпизоды с людьми, одетыми в одежду заданного цвета (верх).
Низ одежды: отобразить только те эпизоды, в которых человек носит одежду низа заданного типа: брюки, юбка, шорты, неопределенный.
Цвет низа одежды: отобразить только эпизоды с людьми, одетыми в одежду заданного цвета (низ).
Головной убор: отобразить только эпизоды с людьми в головном уборе заданного типа: шапка/шляпа/кепка, капюшон/платок, без головного убора.
Сумка в руке: отображать только эпизоды с людьми с сумкой в руке/без сумки в руке.
Сумка на спине: отображать только эпизоды с людьми с сумкой на спине/без сумки на спине.
Жилет: отобразить только эпизоды с людьми, одетыми в жилет заданного цвета.
Каска: отобразить только эпизоды с людьми в каске заданного цвета.
Падение: отображать эпизоды, в которых человек упал (или падает).
Курение: отобразить эпизоды с курящими людьми.
Использование телефона: отобразить эпизоды с людьми, пользующимися телефонами.
Разговор по телефону: отобразить эпизоды с людьми, звонящими или разговаривающими по телефону.
Фотографирование: отобразить эпизоды с людьми, которые фотографируют телефоном экран, документ и прочее.
Специальные фильтры для эпизодов с транспортными средствами
Марка: фильтровать эпизоды по марке транспортного средства.
Модель: фильтровать эпизоды по модели транспортного средства.
Цвет кузова: отобразить эпизоды с транспортными средствами заданного цвета кузова.
Тип кузова: отобразить эпизоды с транспортными средствами заданного типа кузова (минивэн, лимузин и др.).
Страна: отобразить эпизоды с транспортными средствами, зарегистрированными в заданной стране.
Регистрационный номер: найти эпизод с заданным номером транспортного средства.
Категория ТС: отображать только эпизоды с транспортными средствами, принадлежащими заданной категории: мотоцикл, скутер, легковой автомобиль с прицепом, грузовик, грузовик с прицепом, автобус, сочлененный автобус, прочие.
Вес и размер ТС: отобразить эпизоды с транспортными средствами заданного веса и размера кузова.
Спецтранспорт: отображать только эпизоды с транспортными средствами, принадлежащими заданному типу: такси, маршрутный транспорт, каршеринг, скорая помощь, полиция, автомобили МЧС и пожарные машины, газоспасательные и аварийно-спасательные службы, военная техника, коммунальная, строительная техника, прочие.
Ракурс ТС: отобразить эпизоды с транспортными средствами заданного ракурса: ракурс ТС неизвестен, вид спереди, вид сзади, вид сбоку.
Регион: отобразить эпизоды с автомобилями, зарегистрированными в заданном регионе.
Цвет номера: отобразить эпизоды с заданным цветом регистрационного номера транспортного средства.
Примечание
Регион регистрационного знака определяется только для Объединенных Арабских Эмиратов (ОАЭ) и Таиланда. Цвет регистрационного знака определяется только для Саудовской Аравии. Для других стран значения этих атрибутов будут выводиться как неизвестные в результатах распознавания.
Для просмотра событий эпизода щелкните по нужному эпизоду в списке. Вы будете переправлены на вкладку Эпизод с совпадением или Эпизод без совпадения со сведениями об эпизоде и связанными событиями.
Работа с вкладкой События описана в разделе Работа с событиями.
Принятие события и эпизода
Для того чтобы подтвердить эпизод целиком, нажмите Принять в списке эпизодов. В результате все события в эпизоде будут автоматически подтверждены, включая события, которые еще не добавлены (в случае эпизода LIVE).
Эпизод также автоматически подтверждается, если вы приняли все события по отдельности.
Параметры эпизода
Для настройки эпизодов вам понадобится файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
. Найдите следующие параметры в секции FFSECURITY
:
FACE_EPISODES_THRESHOLD
,BODY_EPISODES_THRESHOLD
,CAR_EPISODES_THRESHOLD
: пороговые значения схожести, которые система использует при поиске недавних событий для формирования эпизода. По умолчанию установлены оптимальные значения. При необходимости вы можете изменить их. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).FACE_EPISODE_SEARCH_INTERVAL
,BODY_EPISODE_SEARCH_INTERVAL
,CAR_EPISODE_SEARCH_INTERVAL
: период, предшествующий событию, за который система ищет уже существующие события с похожими объектами в базе данных вектора признаков. Если такое событие не найдено, система создает новый эпизод. В противном случае она сортирует 100 самых последних похожих объектов и выбирает наиболее подходящее событие из эпизода LIVE.EPISODE_MAX_DURATION
: максимальная продолжительность эпизода (в секундах). По истечении этого времени эпизод автоматически закрывается.EPISODE_EVENT_TIMEOUT
: максимальное время ожидания (в секундах) новых событий в открытом эпизоде. По истечении этого времени эпизод автоматически закрывается, если в него не приходили новые события.EPISODE_KEEP_ONLY_BEST_EVENT
: при закрытии эпизода, удалять в нем все события, за исключением события с лучшим объектом. Использование данной опции помогает экономить дисковое пространство.
Если в течение времени, заданного EPISODE_EVENT_TIMEOUT
, в системе регистрируется новое событие с обнаруженным похожим объектом (лицом, силуэтом, ТС), то это событие добавляется к текущему эпизоду, а отсчет времени EPISODE_EVENT_TIMEOUT
возобновляется. Этот процесс повторяется до тех пор, пока суммарное время существования эпизода не достигнет значения EPISODE_MAX_DURATION
(по умолчанию 300 секунд). Если в течение времени EPISODE_EVENT_TIMEOUT
в эпизоде не появляется ни одного нового события, эпизод автоматически закрывается. В случае, когда объект постоянно присутствует в зоне наблюдения, и система непрерывно регистрирует события с его обнаружением, новые эпизоды будут создаваться каждые EPISODE_MAX_DURATION
.
При поступлении нового события система выполняет поиск наиболее подходящего открытого эпизода в пределах интервала FACE_EPISODE_SEARCH_INTERVAL
| BODY_EPISODE_SEARCH_INTERVAL
| CAR_EPISODE_SEARCH_INTERVAL
(в секундах). Поиск основывается на сопоставлении векторов признаков нового события с векторами признаков событий, уже привязанных к открытым эпизодам. Новое событие добавляется к эпизоду, содержащему наиболее похожее событие. Если подходящий эпизод не найден, создается новый эпизод, к которому привязывается данное событие.
Эпизод закрывается при выполнении одного из следующих условий:
Отсутствие новых событий в течение времени, заданного параметром
EPISODE_EVENT_TIMEOUT
(в секундах).Превышение максимальной продолжительности эпизода, определяемой параметром
EPISODE_MAX_DURATION
(в секундах).
После закрытия эпизода, из него формируется событие кластера при условии, что качество наиболее качественного события в эпизоде превышает значение FACE_CLUSTER_EVENT_MIN_QUALITY
| BODY_CLUSTER_EVENT_MIN_QUALITY
| CAR_CLUSTER_EVENT_MIN_QUALITY
, и количество событий в эпизоде превышает значение FACE_CLUSTER_EVENT_MIN_EPISODE_EVENTS
| BODY_CLUSTER_EVENT_MIN_EPISODE_EVENTS
| CAR_CLUSTER_EVENT_MIN_EPISODE_EVENTS
.
Если события с распознанным объектом поступают с разных камер, система объединяет эти события в единый эпизод в соответствии с описанными выше правилами.
При обработке разных видеоархивов, каждый из которых содержит события с распознанным объектом, для каждого видеоархива формируются отдельные эпизоды. При этом правила формирования и закрытия эпизодов, включая EPISODE_EVENT_TIMEOUT
и EPISODE_MAX_DURATION
, остаются идентичными правилам, применяемым к эпизодам, поступающих с камер видеонаблюдения.
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
...
FFSECURITY = {
...
# episodes specific matching threshold that is used to join faces in an episode
'FACE_EPISODES_THRESHOLD': 0.663, # FAR = 1.00E-06 # model: [nectarine_l_320]
'BODY_EPISODES_THRESHOLD': 0.75, # model: [durga]
'CAR_EPISODES_THRESHOLD': 0.61, # model: [bottas]
...
# when closing episode, delete all events except the best episode event
'EPISODE_KEEP_ONLY_BEST_EVENT': False,
# delete episode events after delay in seconds
'EPISODE_DELETE_EVENTS_DELAY': 60,
...
# maximum event age in seconds than could be added to an episode.
'FACE_EPISODE_SEARCH_INTERVAL': 60,
'BODY_EPISODE_SEARCH_INTERVAL': 60,
'CAR_EPISODE_SEARCH_INTERVAL': 60,
# maximum episode duration (episode is closed after)
'EPISODE_MAX_DURATION': 300,
# if no new event added to an episode during this timeout, episode will be closed.
'EPISODE_EVENT_TIMEOUT': 30,
...
}
...
Выполните перезапуск контейнеров FindFace Multi.
cd /opt/findface-multi/
sudo docker-compose restart
См.также