Детекторы#
Детекторы, используемые в подсистеме CARS API, используются для нахождения ТС и ГРЗ на изображении. Детекторы определяют местоположение ТС и ГРЗ, выделяют соответствующие BBox.
В данном разделе приведена информация о детекторах ТС и ГРЗ.
Детекторы ТС и ГРЗ задаются в конфигурационном файле /data/vehicleEngine.conf (см. Приложение 2).
Тестирование работы детекторов возможно в интерфейсе CARS_API_tester (см. CARS Analytics. Руководство администратора).
Детекторы ТС#
Детекторы ТС предназначены для детекции ТС на изображениях. Список детекторов ТС и их описание приведены в Таблице 27.
Таблица 27. Описание детекторов ТС
| Название детектора | Описание |
|---|---|
| VehicleDetectorV4 | Детектор ТС последней версии, который позволяет получать информацию о положении ТС на видеопотоке или видеофайле. Имеет ряд преимуществ: |
| - Улучшенная производительность; | |
| - Повышенная скорость работы; | |
| - Наличие алгоритма повторной детекции ТС (редетекция) для повышения точности работы; | |
| - Возможность работы с изображениями, полученными с камер, установленных на значительной высоте (birdview кадры); | |
| - Исправлена ошибка появления ложных детекций объекта там, где его нет, для придомовых камер. | |
| Данная версия включает в себя настройку дополнительных параметров детектора ТС | |
| VehicleDetectorV2Large | Детектор для работы с видеопотоками, на которых необходимо детектировать ТС как вблизи камеры, так и на дальних планах. То есть в тех случаях, когда разница размеров детекций на одном кадре различается на порядок. При использовании обычного детектора в этом случае мелкие объекты могут быть потеряны |
| VehicleDetectorV3, VehicleDetectorV2, VehicleDetectorV1 | Детекторы ТС прошлого поколения. Данные детекторы позволяют получать информацию о положении ТС на видеопотоке или видеофайле. Наличие возможности использования детектора предыдущей версии обусловлено требованиями обратной совместимости. Во всех новых рабочих контурах рекомендуется использовать детектор VehicleDetectorV4 |
Поля детекций, получаемые при помощи детекторов ТС, описаны в Таблице 28.
Таблица 28. Описание полей детекций ТС
| Поле | Тип | Описание | Возможные значения |
|---|---|---|---|
| detections | Массив, содержащий координаты и размер детекций каждого ТС на изображении, а также оценку точности детекции ТС | Список детектированных ТС, каждая детекция имеет 5 полей: height, score, width, x, y. | |
| 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": 438,
"score": 0.7983,
"width": 915,
"x": 52,
"y": 150
}
],
"detector": "car"
}
Детекторы ГРЗ#
Список детекторов ГРЗ приведен в Таблице 29.
Таблица 29. Описание детекторов ГРЗ
| Название детектора | Описание |
|---|---|
| PlateDetectorV5 | Детектор ГРЗ последней версии, позволяющий получать информацию о положении ГРЗ на изображении. Имеет ряд изменений относительно прошлых версий: |
| - Улучшенная точность; | |
| - Теперь можем детектировать несколько номеров на одном ТС; | |
| - Определение релевантного номера (относятся к нужному ТС); | |
| - Снижена скорость работы относительно PlateDetectorV4. | |
| PlateDetectorV4 | Детектор ГРЗ прошлой версии, позволяющий получать информацию о положении ГРЗ на изображении. Имеет ряд изменений относительно прошлых версий: |
| - Улучшенная производительность; | |
| - Повышенная скорость работы; | |
| - Настройка дополнительных параметров детектора ГРЗ. | |
| PlateDetectorV3, PlateDetectorV2, PlateDetectorV1 | Детекторы ГРЗ 1, 2 и 3 версии – детекторы прошлого поколения, позволяющие получать информацию о положении ГРЗ на последовательности кадров. Наличие возможности использования детекторов предыдущих версии обусловлено требованиями обратной совместимости. Во всех новых рабочих контурах рекомендуется использовать детектор версии 5 |
Поля детекций, получаемые с помощью детекторов ГРЗ, описаны в Таблице 29.
Таблица 29. Описание полей детекций ГРЗ
| Поле | Тип | Описание | Возможные значения |
|---|---|---|---|
| detections | Массив, содержащий координаты и размер детекций каждого ГРЗ на изображении, а также оценку точности детекции ГРЗ | Список детектированных ГРЗ, каждая детекция имеет 5 полей: height, score, width, x, y. | |
| 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": 35,
"score": 0.9343,
"width": 139,
"x": 748,
"y": 444
}
],
"detector": "grz"
}
Детектор животных#
Детектор животных предназначен для детекции и редетекции животных на мультимедийных файлах.
Описание детектора животных приведено в Таблице 30.
Таблица 30. Описание детектора животных
| Название детектора | Описание |
|---|---|
| AnimalDetectorV1 | Детектор животных, позволяет получать информацию о нахождении и положении животных в последовательности кадров. |
Поля детекций, получаемые с помощью детектора животных, описаны в Таблице 31.
Таблица 31. Описание полей детектора животных
| Поле | Тип | Описание | Возможные значения |
|---|---|---|---|
| detections | Массив, содержащий координаты и размер детекций каждого животного на изображении, а также оценку точности детекции | Список детектированных животных, каждая детекция имеет 5 полей: height, score, type, width, x, y. | |
| 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
}