Зоны и маски Frigate: как не спрятать важное вместе с помехами

Сначала сформулируйте, что хотите убрать

Камера видит двор и часть улицы. Люди на тротуаре не должны будить вас сообщением, но запись может быть полезна. В другом углу качается ветка и постоянно создаёт движение. А неподвижный предмет иногда определяется как человек. На первый взгляд хочется закрасить всё лишнее одной маской. Но эти ситуации находятся на разных ступенях обработки.

Запишите нужный результат отдельно для каждой области: не отправлять сообщение, не использовать движение как повод для детекции или отбрасывать определённый ложный объект. Тогда выбор настройки становится понятным. В разборе записи и событий уже разделены потоки и архив; здесь разберём, как место в кадре влияет на отбор.

Зона обозначает место, которое вас интересует

Зона — область кадра с именем. Присутствие объекта в ней Frigate оценивает по середине нижней стороны его ограничивающей рамки, а не по доле пересечения всей рамки с областью. Если верх человека уже накрыл двор, а нижняя точка ещё на улице, принадлежность зоне может отличаться от первого визуального впечатления. Правило описано в документации зон.

На схеме точка находится внутри двора. На своём видео проверьте несколько подходов и пересечение границы зоны. Назовите зону по назначению, например «подход к двери»: так её проще узнать в настройках уведомлений.

Зону нужно связать с нужной политикой

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

Review — интервал активности, который может включать несколько объектов; уровни интереса определяют, что вы будете просматривать как более важное. Эти роли объясняет документация Review. Не путайте признак входа объекта в зону с подтверждением, что он всё ещё там находится в момент более поздней команды.

Маска движения и маска объекта работают по-разному

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

Маска фильтра объекта отбрасывает детекции конкретного типа по положению нижней центральной точки рамки. Это более узкий инструмент для постоянного ложного объекта в известном месте. Различия и ограничения показаны в документации масок. Не закрывайте ею реальный путь человека только потому, что в одном кадре там возникло ложное срабатывание.

Настройте по одной причине и проверьте противоположный случай

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

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

Проверьте человека на границе кадра

В условном дворе человек сначала виден за ограждением, затем подходит к двери. Сохраните два момента: рамка пересекла рисунок зоны и нижняя точка вошла в него. Это помогает объяснить, почему признак зоны появился позже, чем вы ожидали. Затем проверьте обратный проход. Если рамка скачет возле границы, изучайте именно этот эпизод и параметры зоны, а не закрывайте большой участок кадра маской.

Отдельный случай — изменение положения камеры. Полигон нарисован в координатах изображения; после поворота прежний рисунок может соответствовать уже другому месту. Снова пройдите интересующий маршрут и сравните кадр с назначением зоны. Проверка должна включать реальный важный проход, ожидаемый лишний проход и место прежнего ложного объекта. Так видно, улучшилась ли задача целиком. Исчезновение одного сообщения без сохранения нужного события нельзя считать достаточным результатом: причиной тишины мог оказаться слишком широкий фильтр. Все эти проверки относятся к выбранной камере и условиям кадра, а не к общей оценке точности Frigate.

Сохраните проверку всей цепочки

1. Нужный объект. Он обнаружен в доступном кадре и имеет ожидаемый тип.
2. Нужное место. Нижняя точка рамки прошла через выбранную область; граничный случай объясним.
3. Нужный review. Уровень и правила требуемых зон соответствуют вашей задаче.
4. Нужное сообщение. Автоматизация использовала именно этот источник, а повторные обновления не создали лишних уведомлений.
5. Нужный архив. Сроки и запись проверены отдельно. Маска аналитики не заменяет настройку приватности и не описывает содержимое всех сохранённых потоков.