Перейти к содержанию

Детекторы#

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

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

Тестирование работы детекторов доступно через интерфейс CARS API Tester (см. «CARS Analytics. Руководство администратора»).

Детектор ТС#

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

Детектор ТС последней версии включает алгоритм повторной детекции (редетекции) для повышения точности, возможность работы с изображениями, полученными с камер, установленных на значительной высоте (birdview), а также настройку дополнительных параметров детектора ТС.

Пример входного изображения представлен на Рисунке 27.

Пример входного изображения для детектора ТС
Пример входного изображения для детектора ТС

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

{
      "detections": [
        {
          "x": 637.8615112304688,
          "y": 161.5411834716797,
          "width": 426.82147216796875,
          "height": 274.2376708984375,
          "score": 0.9445058107376099
        },
        {
          "x": 115.89066314697266,
          "y": 155.4100341796875,
          "width": 476.1069030761719,
          "height": 282.51666259765625,
          "score": 0.9419910907745361
        }
      ],
      "detector": "car",
      "execution_time": 53
}

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

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

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

Детектор ГРЗ предназначен для обнаружения номерных знаков (ГРЗ) на изображениях и позволяет получать информацию о положении ГРЗ в видеопотоке или видеофайле.

Детектор ГРЗ последней версии включает возможность детектировать несколько номеров на одном транспортном средстве, а также определяет релевантный номер, относящийся к нужному транспортному средству. Кроме того, доступна настройка дополнительных параметров детектора ГРЗ.

Пример входного изображения представлен на Рисунке 28.

Пример входного изображения для детектора ГРЗ
Пример входного изображения для детектора ГРЗ

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

{
      "detections": [
        {
          "x": 119.0,
          "y": 483.0,  
          "width": 156.0,
          "height": 97.0,
          "score": 0.93145
        },
        {
          "x": 112.0,
          "y": 533.0,
          "width": 137.0,
          "height": 88.0,
          "score": 0.82027
        }
      ],
      "detector": "grz",
      "execution_time": 53
    }

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

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

Редетектор ТС#

Редетектор ТС предназначен для детекции ТС в заданной зоне кадра. Этот метод позволяет возвращать координаты BBox ТС, найденного в указанной области изображения.

При использовании редетектора ТС можно отправлять фотографии и детекции для выполнения повторной детекции (редетекции) транспортных средств. Процесс включает в себя загрузку изображения, предварительную обработку, и выполнение редетекции для повышения точности работы. Редетектор позволяет детектировать несколько ТС в одном кадре и корректно определять их местоположение. В случае ошибок или неудачных попыток редетекции, система возвращает описание ошибки с соответствующими деталями.

Пример входного изображения представлен на Рисунке 29.

Пример входного изображения для Редектора ТС
Пример входного изображения для Редектора ТС

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

{
      "detections": [
        {
          "x": 162,
          "y": 103, 
          "width": 1072,
          "height": 749,
          "score": 0.6372541785240173
        }
      ],
      "execution_time": 20,
      "redetector": "car"
    }

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

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

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

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

Пример входного изображения представлен на Рисунке 30.

Пример входного изображения для Детектора дыма и/или огня
Пример входного изображения для Детектора дыма и/или огня

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

{
    "detections": [
        {
            "x": 0,
            "y": 0,
            "width": 960,
            "height": 540,
            "score": 0.8205,
            "type": "fire"
        }
    ],
    "execution_time": 51,
    "detector": "smoke_fire"
}

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

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

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

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

Пример входного изображения представлен на Рисунке 31.

Пример входного изображения для Детектора животных
Пример входного изображения для Детектора животных

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

{
    "detections": [
        {
            "x": 323,
            "y": 42,
            "width": 137,
            "height": 342,
            "score": 0.9622,
            "type": "big_animal"
        }
    ],
    "execution_time": 60,
    "detector": "animal"
}

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

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

Настройка детекторов#

Настройка детекторов позволяет получить текущие параметры детекторов ТС и ГРЗ, включая пороги точности детекции и размеры изображений. Метод возвращает актуальные настройки для этих детекторов.

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

{
  "detectorsSettings": [
    {
      "detector": "car",
      "scoreThreshold": 0.5,
      "imageSize": 640
    },
    {
      "detector": "grz",
      "scoreThreshold": 0.5,
      "imageSize": 220
    }
  ]
}

Таблица 39. Описание полей наcтройки

Поле Тип Описание Возможные значения
detectorsSettings array Массив с текущими настройками для детекторов ТС и ГРЗ Список объектов с параметрами настройки
detector string Тип детектора car, grz
scoreThreshold float Порог точности детекции 0.0000…1.0000
imageSize int Размер изображения для детектора 100…1280