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

Приложение 3. Описание параметров конфигурационного файла «TrackEngine.conf»#

Параметр Описание Возможные значения Значение по умолчанию Рекомендация по изменению
Параметры логирования logging
mode Режим логирования работы библиотеки Track Engine - l2c – выводить информацию в консоль; l2b
- l2f – выводить информацию в файл;
- l2b – выводить информацию в файл и в консоль
severity Тип логируемой информации - 0 – предупреждения и ошибки; 1
- 1 – предупреждения;
- 2 – ошибки
Общие параметры other
detector-step Частота детекции ТС и ГРЗ в заданной области до выполнения редетецекции 0...30 7
detector-comparer Режим сравнения детекций ТС и ГРЗ для выбора лучшего кадра - 0 – DctConfidence; 1
- 1 – DctCenter;
- 2 – DctCenterAndConfidence;
- 3 – DctSize
use-one-detection-mode Выбор режима детектирования - 0 – неограниченное количество детекций на 1 кадре; 0
- 1 – одна детекция на 1 кадр
skip-frames Количество кадров, которые должны быть пропущены, если не было детекций ТС на кадре. Если детектор ничего не обнаружил будет выполнен пропуск кадров для экономии ресурсов, через указанное количество кадров CARS Stream будет детектировать ТС повторно 0...50 36
frg-subtractor Режим учета перемещений в кадре. Последующая детекция ТС и ГРЗ будет выполняться только в областях с движением. - 0 – режим учета включен; 0
Включение параметра увеличивает производительность работы CARS Stream - 1 – режим учета выключен
frames-buffer-size Количество кадров в буфере кадров CARS Stream. Не влияет на производительность. При уменьшении размера буфера возможен пропуск кадров на RTSP потоке 10...1000 64
amount-of-free-space-in-buffer Количество свободного места в буфере кадров CARS Stream (измеряется в количестве кадров) 1...1000 32
wait-other-streams-for-processing-time Время ожидания готовности других потоков перед обработкой кадров (в мс.) 10...1000 500
callback-buffer-size Размер буфера для накопления функций передачи информации во внешние системы 10...1000 300
max-processing-fragments-count Максимальное количество фрагментов для потока, обрабатываемого за время. (0 – без ограничения; больше 10 – забирать все кадры потока) 0...10 600
batched-processing Пакетная обработка кадров. Позволяет выполнять детекцию и редетекцию на нескольких одинаковых или близких по размеру изображениях одновременно. Включение данного параметра ускоряет время работы методов детекции и редетекции кадров - 0 – Без пакетной обработки; 1
- 1 – Включение пакетной обработки
min-frames-batch-size Значение минимального размера пакета кадров для обработки. Более высокие значения приводят к большей задержке обработки, но увеличивают пропускную способность устройства. Нулевые/отрицательные значения отключают эту функцию, поэтому будут обрабатываться любые потоковые кадры, если они доступны. Параметр не используется в текущем функционале - 0
max-frames-batch-gather-timeout Максимальное доступное время ожидания для сбора следующего пакета кадров потока с момента начала последней обработки (измеряется в мс). Параметр не используется в текущем функционале - 0
parallel-tracks-processing Обрабатывать треки, созданные после детекции и редетекции, параллельно или обрабатывать все треки вместе - 0 – параллельно; 0
- 1 – совместно
frg-regions-alignment Выравнивание фрагментов изображений. Настройка повышает производительность. 0 или отрицательные значения означают использование не выровненных областей - 0 – выключено; 0
- 1 – включено
frg-regions-square-alignment Приведение фрагментов изображений к одному размеру. Выбирается размер большей стороны кадра - 0 – выключено; 0
- 1 – включено
detector-scaling Масштабирование кадров перед обработкой. Необходимо для снижения времени обработки - 0 – масштабирование включено; 0
- 1 – масштабирование выключено
scale-result-size Максимальный размер кадра после масштабирования по наибольшей из сторон кадра. Если исходный кадр имел размер 1920х1080 и значение «scale-result-size» равно 640, то разрешение кадра будет изменено до 640х360. Время детекции уменьшается при снижении разрешения кадра 320...1280 640
max-detection-count Максимальное количество детекций на кадре. Чем больше данный параметр, тем больше ТС CARS Stream сможет детектировать параллельно. Увеличение необходимо для загруженных дорог с плотным потоком движения 1...1000 20
minimal-track-length Минимальное количество кадров в одном треке 1...1000 2
tracker-type Тип используемого трекера. Трекер – это алгоритм предсказания для детекторов и редетекторов, где предположительно будет находиться детектируемый объект в следующем кадре. Улучшает производительность и сокращает время на процессы детекции и редетекции - kcf; carkalmanV2
- opencv;
- carkalman;
- carkalmanV2
- vlTracker;
- none
kill-intersected-detections Параметр отвечает за уничтожение пересекающихся детекций различных ТС. Позволяет избежать перехода с одного ТС на другое в рамках одного трека - 0 – не уничтожать пересекающиеся детекции; 1
- 1 – уничтожать пересекающиеся детекции
kill-intersection-value Параметр отвечает за уничтожение одного из треков при IOU больше выставленного значения 0…1 0.6
build-intersection-value Параметр отвечает за привязку BBox к конкретному треку при IOU больше выставленного значения 0…1 0.3
Параметры ТС Vehicle
best-shots-number-for-track Количество лучших кадров в одном треке 1...1000 5
Параметры трекинга лиц Face
face-landmarks-detection Параметр отвечает за определение ключевых точек лица. Отключение данного параметра увеличивает производительность - 0 – определять ключевые точки; 1
- 1 – не определять ключевые точки
Параметры трекинга пешеходов Human
human-landmarks-detection Параметр отвечает за определение ключевых точек тела. Отключение данного параметра увеличивает производительность - 0 – определять ключевые точки; 1
- 1 – не определять ключевые точки
remove-overlapped-strategy Параметр, определяющий стратегию удаления наложившихся друг на друга детекций после процесса ре-детекции. Значение определяет, какие именно детекции удалять. - none – не удалять ничего; score
- both – удалять обе;
- score – удалять с меньшей оценкой качества
remove-horizontal-ratio Пороговое значение отношения ширины к высоте, используемое для удаления горизонтальных детекций – то есть детекций, ширина которых больше высоты. При значении выше установленного, система определит детекцию как горизонтальную и выполнит ее удаление. Данный параметр используется только в рамках детекции пешеходов 1.000…2.000 1.6
iou-connection-threshold Пороговое значение IOU для сопоставления треков и детекций 0…1 0.5
reid-matching-threshold Пороговое значение ре-идентификации для связи треков друг с другом при разрыве. Используется только для трекинга людей 0...1 0.85
non-active-tracks-lifetime Время жизни неактивных треков, использованных для ре-идентификации. Параметр измеряется в количестве кадров и используется для сопоставления треков друг с другом. Более высокие значения предполагают более точную ре-идентификацию, но снижают производительность 0...1000 100
reid-matching-detections-number Количество детекций, которое необходимо для ре-идентификации трека 0…100 7
use-reid Использование ре-идентификации треков - 0 – не использовать; 0
- 1 – использовать
frames-to-kill-track Количество кадров без детекции пешеходов, которое необходимо для завершения трека. Данный параметр работает только при отключенном параметре use-reid 1…200 4
Параметры детекторов detectors
use-face-detector Включение работы детектора лиц. Экспериментальный режим работы - 0 – выключить детектор; 0
- 1 – включить детектор
use-body-detector Включение работы детектора тел - 0 – выключить детектор; 1
- 1 – включить детектор
use-vehicle-detector Включение работы детектора ТС - 0 – выключить детектор; 1
- 1 – включить детектор
use-license-plate-detector Включение работы детектора ГРЗ. При выключении вызовет ошибку работу системы - 0 – выключить детектор; 1
- 1 – включить детектор
use-animal-detector Включение работы детектора животных - 0 – выключить детектор; 1
- 1 – включить детектор
Параметры стратегии ведения треков ТС
strategy Стратегия ведения треков и отправки лучших кадров в CARS Stream библиотекой TrackEngine. Работа стратегий описана в п.4.3 - common; coroutineV2
- redetect;
- droi;
- droiFgs;
- lpDroi;
- coroutine;
- coroutineV2
strategyPriority Rank Приоритет выбора лучших детекций - common – лучшей детекцией считается детекция наибольшего размера; bottom
- bottom – лучшей детекцией считается детекция, находящаяся ближе всего к нижней границе кадра
BottomRankDelta Минимальное расстояние до нижней границы экрана для выбора лучшей детекции при использовании стратегии «bottom» в параметре «strategyPriorityRank» 10...100 80
redetect-merge-intersection-detection-threshold Значение порога для объединения схожих детекцией 0…1 0.5
Отладка работы
save-debug-info Режим отладки CARS Stream - 0 – включить режим отладки; 0
- 1 – выключить режим отладки
show-profiling-data Вывод лог работы CARS Stream - 0 – включить режим отладки; 0
- 1 – выключить режим отладки
save-buffer-log Сохранение логов работы буфера - 0 – включить режим отладки; 0
- 1 – выключить режим отладки