Детекторы

Детекторы, используемые в подсистеме CARS API, используются для нахождения ТС и ГРЗ на изображении. Детекторы определяют местоположение ТС и ГРЗ, выделяют соответствующие BBox.

В данном разделе приведена информация о детекторах ТС и ГРЗ.

Детекторы ТС и ГРЗ задаются в конфигурационном файле /data/vehicleEngine.conf (см. Приложение 2).

Тестирование работы детекторов возможно в интерфейсе CARS_API_tester (см. CARS Analytics. Руководство администратора).

Детекторы ТС

Детекторы ТС предназначены для детекции ТС на изображениях. Список детекторов ТС и их описание приведены в Таблице 27.

Таблица 27. Описание детекторов ТС

Название детектора	Описание
VehicleDetectorV4	Детектор ТС последней версии, который позволяет получать информацию о положении ТС на видеопотоке или видеофайле. Имеет ряд преимуществ:
	- Улучшенная производительность;
	- Повышенная скорость работы;
	- Наличие алгоритма повторной детекции ТС (редетекция) для повышения точности работы;
	- Возможность работы с изображениями, полученными с камер, установленных на значительной высоте (birdview кадры);
	- Исправлена ошибка появления ложных детекций объекта там, где его нет, для придомовых камер.
	Данная версия включает в себя настройку дополнительных параметров детектора ТС

Поля детекций, получаемые при помощи детекторов ТС, описаны в Таблице 28.

Таблица 28. Описание полей детекций ТС

Поле	Тип	Описание	Возможные значения
detections		Массив, содержащий координаты и размер детекций каждого ТС на изображении, а также оценку точности детекции ТС	Список детектированных ТС.
execution_time	int	Время исполнения в миллисекундах	-
height	int	Высота BBox	0…1080
score	float	Оценка точности детекции ТС	0.0000…1.0000
width	int	Ширина BBox	0…1920
x	int	Горизонтальная координата левого верхнего угла BBox	0…1920
y	int	Вертикальная координата левого верхнего угла BBox	0…1080
detector	string	Название типа детектора	car

Пример ответа:

{
    "detections": [
        {
            "height": 298,
            "score": 0.9394,
            "width": 514.006,
            "x": 0,
            "y": 0
        }
    ],
    "detector": "car",
    "execution_time": 153
}

Детекторы ГРЗ

Список детекторов ГРЗ приведен в Таблице 29.

Таблица 29. Описание детекторов ГРЗ

Название детектора	Описание
PlateDetectorV5	Детектор ГРЗ, позволяющий получать информацию о положении ГРЗ на изображении. Имеет ряд изменений относительно прошлых версий:
	- Улучшенная точность;
	- Позволяет детектировать несколько номеров на одном ТС;
	- Определение релевантного номера (относятся к нужному ТС);
	- Настройка дополнительных параметров детектора ГРЗ.

Поля детекций, получаемые с помощью детекторов ГРЗ, описаны в Таблице 29.

Таблица 29. Описание полей детекций ГРЗ

Поле	Тип	Описание	Возможные значения
detections		Массив, содержащий координаты и размер детекций каждого ГРЗ на изображении, а также оценку точности детекции ГРЗ	Список детектированных ГРЗ.
execution_time	int	Время исполнения в миллисекундах	-
height	int	Высота BBox	0…1080
score	float	Оценка точности детекции ГРЗ	0.0000…1.0000
width	int	Ширина BBox	0…1920
x	int	Горизонтальная координата левого верхнего угла BBox	0…1920
y	int	Вертикальная координата левого верхнего угла BBox	0…1080
detector	string	Название типа детектора	grz

Пример ответа:

{
    "detections": [
        {
            "height": 40,
            "score": 1,
            "width": 72,
            "x": 413,
            "y": 217
        }
    ],
    "detector": "grz",
    "execution_time": 252
}

Детектор животных

Детектор животных предназначен для детекции и редетекции животных на мультимедийных файлах.

Описание детектора животных приведено в Таблице 30.

Таблица 30. Описание детектора животных

Название детектора	Описание
AnimalDetectorV1	Детектор животных, позволяет получать информацию о нахождении и положении животных в последовательности кадров.

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

Таблица 31. Описание полей детектора животных

Поле	Тип	Описание	Возможные значения
detections		Массив, содержащий координаты и размер детекций каждого животного на изображении, а также оценку точности детекции	Список детектированных животных
execution_time	int	Время исполнения в миллисекундах	-
height	int	Высота BBox	0…1080
score	float	Оценка точности детекции животного	0.0000…1.0000
type	string	Тип	big_animal, small_animal, bird
width	int	Ширина BBox	0…1920
x	int	Горизонтальная координата левого верхнего угла BBox	0…1920
y	int	Вертикальная координата левого верхнего угла BBox	0…1080
detector	string	Название типа детектора	animal

Пример ответа:

{
    "detections": [
        {
            "height": 708,
            "score": 0.921549916267395,
            "type": "small_animal",
            "width": 1269,
            "x": 1,
            "y": 214
        }
    ],
    "detector": "animal",
    "execution_time": 167
}

Детектор дыма и огня

Детектор дыма и огня предназначен для детекции возгораний на видеопотоках и видеофайлах.

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

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

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

Поля детекций, получаемые с помощью детектора дыма и огня, описаны в Таблице 33.

Таблица 33. Описание полей детектора дыма и огня

Поле	Тип	Описание	Возможные значения
detections		Массив, содержащий координаты, размер зоны обнаружения и наличие огня или дыма на изображении, а также оценку точности детекции	Список детектированных зон
height	int	Высота зоны обнаружения	0…1080
score	float	Оценка точности детекции дыма или огня	0.0000…1.0000
type	string	Тип	- fire - огонь;
			- black_smoke - черный дым;
			- white_smoke - белый дым;
			- none - нет возгорания.
width	int	Ширина зоны обнаружения	0…1920
x	int	Горизонтальная координата левого верхнего угла зоны детекции	0…1920
y	int	Вертикальная координата левого верхнего угла зоны детекции	0…1080
detector	string	Название типа детектора	smoke_fire
execution_time	int	Время исполнения в миллисекундах	-

Пример ответа:

{
    "detections": [
        {
            "height": 958,
            "score": 0.828738808631897,
            "type": "fire",
            "width": 955,
            "x": 0,
            "y": 0
        }
    ],
    "detector": "smoke_fire",
    "execution_time": 518
}