Области интереса (ROI)

Область интереса (от англ. Region of Interest (ROI)) — область, размечаемая поверх кадра видеопотока. OMNI Agent обнаруживает присутствие и выполняет отслеживание объектов определенных классов в размеченной области. Результаты обнаружения входа/выхода и отслеживания присутствия передаются в OMNI Platform или внешний сервис в формате процессов и событий.

В областях интереса могут отслеживаться следующие классы объектов:

• тело человека;
• лицо человека;
• отдельные джоинты скелета человека: ладонь, лодыжка, колено и др.

В одной области интереса одновременно могут отслеживаться несколько классов объектов.

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

Нахождение объекта в области интереса определяется по координатам единственной точки на кадре, полученной преобразованием точек рамки обнаружения объекта (bbox).

По умолчанию OMNI Agent использует следующие методы преобразования bbox:

• тело человека - середина нижней границы bbox;
• лицо человека - центр bbox;
• отдельные джоинты скелета человека - центр bbox.

подсказка

Для включения только детекции джоинтов скелета поставьте значение true в поле pipelines.pose_estimation.enable файла run_params.json.

Как добавить область интереса

1. Нажмите на шестеренку в строке камеры. В разделе ROI открывшейся вкладки нажмите +.

2. Укажите название области интереса, выберите тип «Регион» и отметьте классы отслеживаемых объектов. Разметьте область интереса на превью с камеры и нажмите Сохранить.

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

Конфигурация области интереса

Создать или изменить настройки области интереса можно в файле конфигурации run_params.json, отредактировав следующие поля объекта mutlistream_ROI:

• regions: массив объектов областей интереса.

Пример объекта в массиве regions:

"regions": [
{ // объект (область интереса)
    "name": "_region_name_", // название области интереса
    "classes": [
        {
            "class": "body", // класс отсеживаемых объектов
            "reduction_kind": "BBOX_BOTTOM_CENTER", // метод преобразования bbox объекта в точку
        },
        {
            "class": "face",
            "reduction_kind": "BBOX_CENTER",
        },
        {
            "class": "left_hand",
            "reduction_kind": "BBOX_CENTER",
        }
    ],
    "points": [ // координаты точек, ограничивающих область интереса
        {
            "x": 0,
            "y": 0.975 // в относительных координатах фрейма
        },
        {
            "x": 1,
            "y": 0.975
        },
        {
            "x": 0.5,
            "y": 0.5
        }
    ],
    "uuid": "6acb27c7-c967-46ed-a32f-0085c0454c4c" // uuid области интереса. При отсутствии добавляется автоматически. 
  }
]