Конфигурирование Vehicle Engine LCA API

В разделе приведено описание параметров конфигурационного файла vehicleEngine.conf.

Общие параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
logSeverity	Задает уровень логирования Vehicle Engine	- 4 — режим отладки; - 3 — информация о работе и сообщения уровня 4; - 2 — предупреждения и сообщения уровня 3; - 1 — ошибки и сообщения уровня 2; - 0 — логирование отключено
profiling	Включает или отключает профилирование	- 0 — выключено; - 1 — включено
defaultVehicleDetectorType	Детектор ТС, используемый по умолчанию	VehicleDetectorV4
defaultPlateDetectorType	Детектор ГРЗ, используемый по умолчанию	PlateDetectorV5
defaultAnimalDetectorType	Детектор животных, используемый по умолчанию	AnimalDetectorV1
defaultSmokeFireDetectorType	Детектор дыма и огня, используемый по умолчанию	SmokeFireDetectorV1
defaultAggregatedPlateAttributesEstimatorType	Версия алгоритма оценки точности распознанных атрибутов ГРЗ. Каждая версия поддерживает определенный набор стран. Подробнее см. в конфигурационном файле plate_aggregated_*.conf, входящем в поставку API.	V4; V5
defaultCountryPlateEstimatorType	Версия алгоритма оценки точности определения страны принадлежности ГРЗ. Каждая версия поддерживает определенный набор стран. Подробнее см. в конфигурационном файле grz_country_recognition_*.conf, входящем в поставку API.	V4

Эстиматор AggregatedPlateAttributesEstimator

AggregatedPlateAttributesEstimator — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
nonZeroingLPDataScoreThreshold	Задает порог, ниже которого результаты распознавания ГРЗ считаются недостоверными и соответствующие данные обнуляются	0.000…1.000
complexedLPScoreCalcPolicy	Позволяет рассчитывать агрегированную оценку точности распознавания ГРЗ на основе усреднения оценки распознавания ГРЗ и оценки распознавания страны принадлежности ГРЗ	None — выключено; AveragingWithLPCountryScore — включено

Эстиматор LicensePlateEstimator

LicensePlateEstimator — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
aggregatedLPScoreCalcPolicy	Позволяет выбрать метод расчета агрегированной оценки точности распознавания ГРЗ	Multiplication — перемножение оценок распознавания символов; Average — среднее арифметическое оценок распознавания символов;Median — медианное значение оценок распознавания символов

Детектор VehicleDetectorV4

VehicleDetectorV4 — параметры, запрещенные к изменению

Параметр	Описание	Возможные значения
	Запрещено изменять
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество детекции. Для изображений с большим количеством объектов рекомендуется использовать детектор VehicleDetectorV2Large.	320…1280
minInputSize	Задает минимально допустимый размер изображения (в пикселях) для выполнения inference. Значение должно быть меньше imageSize. Параметр имеет фиксированное значение и не подлежит изменению.	—
squareFormat	Включает или отключает преобразование изображения в квадратный формат путем добавления черных полей по краям. Использование квадратного формата увеличивает время обработки изображения.	0 — включено; 1 — выключено
minSize	Задает минимальный размер детекции. Детекции меньшего размера не возвращаются в ответе и не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—
redetectImageSize	Задает размер стороны квадратного изображения (в пикселях), используемого для повторной детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество повторной детекции.	100…1280
redetectExpandCoeff	Задает коэффициент расширения области изображения перед выполнением повторной детекции.	1.000…2.000 (по умолчанию — 1.4375)
redetectSquareThreshold	Задает порог площади для фильтрации результатов повторной детекции. Детекции с площадью меньше заданного значения не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—

VehicleDetectorV4 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения ТС, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
SecondNMSThreshold	Задает дополнительный порог алгоритма NMS для выполнения повторной обработки. Значение должно быть больше NMSThreshold. Увеличение значения позволяет снизить количество ложноположительных детекций.	0.000…1.000
detectionToFrameRatioThreshold	Задает порог отношения площади детекции к площади кадра.	0.000…1.000
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox
redetectScoreThreshold	Задает минимальную оценку точности повторной детекции ТС. Увеличение значения уменьшает количество ложноположительных результатов повторной детекции.	0.000…1.000 (по умолчанию — 0.25)
redetectOneNMSThreshold	Задает порог алгоритма NMS, используемый на первом этапе повторной детекции. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.4)
redetectNMSThreshold	Задает дополнительный порог алгоритма NMS для повторной детекции ТС. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.5)
redetectNMS	Задает режим работы алгоритма подавления пересекающихся BBox при повторной детекции ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox

VehicleDetectorV4 — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
ScoreThreshold	Задает минимальную оценку точности детекции ТС. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных ТС.	0.000…1.000
alignment	Задает выравнивание размеров входного изображения. Параметр используется только при squareFormat = 0. При обработке изображение дополняется черными полями до заданного размера по высоте или ширине. Использование параметра повышает производительность пакетной обработки. Значение должно быть равно степени двойки (2, 4, 8, 16, …).	2…512
maxFlowerBatchSize	Задает максимальное количество изображений, одновременно передаваемых на inference.	1…16

Детектор VehicleDetectorV5

VehicleDetectorV5 — параметры, запрещенные к изменениям

Параметр	Описание	Возможные значения
	Запрещено изменять
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество детекции. Для изображений с большим количеством объектов рекомендуется использовать детектор VehicleDetectorV2Large.	320…1280
minInputSize	Задает минимально допустимый размер изображения (в пикселях) для выполнения inference. Значение должно быть меньше imageSize. Параметр имеет фиксированное значение и не подлежит изменению.	—
squareFormat	Включает или отключает преобразование изображения в квадратный формат путем добавления черных полей по краям. Использование квадратного формата увеличивает время обработки изображения.	0 — включено; 1 — выключено
minSize	Задает минимальный размер детекции. Детекции меньшего размера не возвращаются в ответе и не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—
redetectImageSize	Задает размер стороны квадратного изображения (в пикселях), используемого для повторной детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество повторной детекции.	100…1280
redetectExpandCoeff	Задает коэффициент расширения области изображения перед выполнением повторной детекции.	1.000…2.000 (по умолчанию — 1.4375)
redetectSquareThreshold	Задает порог площади для фильтрации результатов повторной детекции. Детекции с площадью меньше заданного значения не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—

VehicleDetectorV5 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения ТС, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
SecondNMSThreshold	Задает дополнительный порог алгоритма NMS для выполнения повторной обработки. Значение должно быть больше NMSThreshold. Увеличение значения позволяет снизить количество ложноположительных детекций.	0.000…1.000
detectionToFrameRatioThreshold	Задает порог отношения площади детекции к площади кадра.	0.000…1.000
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox
redetectScoreThreshold	Задает минимальную оценку точности повторной детекции ТС. Увеличение значения уменьшает количество ложноположительных результатов повторной детекции.	0.000…1.000 (по умолчанию — 0.25)
redetectOneNMSThreshold	Задает порог алгоритма NMS, используемый на первом этапе повторной детекции. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.4)
redetectNMSThreshold	Задает дополнительный порог алгоритма NMS для повторной детекции ТС. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.5)
redetectNMS	Задает режим работы алгоритма подавления пересекающихся BBox при повторной детекции ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox

VehicleDetectorV5 — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
ScoreThreshold	Задает минимальную оценку точности детекции ТС. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных ТС.	0.000…1.000
alignment	Задает выравнивание размеров входного изображения. Параметр используется только при squareFormat = 0. При обработке изображение дополняется черными полями до заданного размера по высоте или ширине. Использование параметра повышает производительность пакетной обработки. Значение должно быть равно степени двойки (2, 4, 8, 16, …).	2…512
maxFlowerBatchSize	Задает максимальное количество изображений, одновременно передаваемых на inference.	1…16

Детектор VehicleDetectorV6

VehicleDetectorV6 — параметры, запрещенные к изменениям

Параметр	Описание	Возможные значения
	Запрещено изменять
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество детекции. Для изображений с большим количеством объектов рекомендуется использовать детектор VehicleDetectorV2Large.	320…1280
minInputSize	Задает минимально допустимый размер изображения (в пикселях) для выполнения inference. Значение должно быть меньше imageSize. Параметр имеет фиксированное значение и не подлежит изменению.	—
squareFormat	Включает или отключает преобразование изображения в квадратный формат путем добавления черных полей по краям. Использование квадратного формата увеличивает время обработки изображения.	0 — включено; 1 — выключено
minSize	Задает минимальный размер детекции. Детекции меньшего размера не возвращаются в ответе и не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—
redetectImageSize	Задает размер стороны квадратного изображения (в пикселях), используемого для повторной детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество повторной детекции.	100…1280
redetectExpandCoeff	Задает коэффициент расширения области изображения перед выполнением повторной детекции.	1.000…2.000 (по умолчанию — 1.4375)
redetectSquareThreshold	Задает порог площади для фильтрации результатов повторной детекции. Детекции с площадью меньше заданного значения не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—

VehicleDetectorV6 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения ТС, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
SecondNMSThreshold	Задает дополнительный порог алгоритма NMS для выполнения повторной обработки. Значение должно быть больше NMSThreshold. Увеличение значения позволяет снизить количество ложноположительных детекций.	0.000…1.000
detectionToFrameRatioThreshold	Задает порог отношения площади детекции к площади кадра.	0.000…1.000
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox
redetectScoreThreshold	Задает минимальную оценку точности повторной детекции ТС. Увеличение значения уменьшает количество ложноположительных результатов повторной детекции.	0.000…1.000 (по умолчанию — 0.25)
redetectOneNMSThreshold	Задает порог алгоритма NMS, используемый на первом этапе повторной детекции. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.4)
redetectNMSThreshold	Задает дополнительный порог алгоритма NMS для повторной детекции ТС. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.5)
redetectNMS	Задает режим работы алгоритма подавления пересекающихся BBox при повторной детекции ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox

VehicleDetectorV6 — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
ScoreThreshold	Задает минимальную оценку точности детекции ТС. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных ТС.	0.000…1.000
alignment	Задает выравнивание размеров входного изображения. Параметр используется только при squareFormat = 0. При обработке изображение дополняется черными полями до заданного размера по высоте или ширине. Использование параметра повышает производительность пакетной обработки. Значение должно быть равно степени двойки (2, 4, 8, 16, …).	2…512
maxFlowerBatchSize	Задает максимальное количество изображений, одновременно передаваемых на inference.	1…16

Детектор VehicleDetectorV7

VehicleDetectorV7 — параметры, запрещенные к изменениям

Параметр	Описание	Возможные значения
	Запрещено изменять
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество детекции. Для изображений с большим количеством объектов рекомендуется использовать детектор VehicleDetectorV2Large.	320…1280
minInputSize	Задает минимально допустимый размер изображения (в пикселях) для выполнения inference. Значение должно быть меньше imageSize. Параметр имеет фиксированное значение и не подлежит изменению.	—
squareFormat	Включает или отключает преобразование изображения в квадратный формат путем добавления черных полей по краям. Использование квадратного формата увеличивает время обработки изображения.	0 — включено; 1 — выключено
minSize	Задает минимальный размер детекции. Детекции меньшего размера не возвращаются в ответе и не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—
redetectImageSize	Задает размер стороны квадратного изображения (в пикселях), используемого для повторной детекции ТС. Значение параметра является фиксированным и обеспечивает оптимальное качество повторной детекции.	100…1280
redetectExpandCoeff	Задает коэффициент расширения области изображения перед выполнением повторной детекции.	1.000…2.000 (по умолчанию — 1.4375)
redetectSquareThreshold	Задает порог площади для фильтрации результатов повторной детекции. Детекции с площадью меньше заданного значения не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—

VehicleDetectorV7 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения ТС, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
SecondNMSThreshold	Задает дополнительный порог алгоритма NMS для выполнения повторной обработки. Значение должно быть больше NMSThreshold. Увеличение значения позволяет снизить количество ложноположительных детекций.	0.000…1.000
detectionToFrameRatioThreshold	Задает порог отношения площади детекции к площади кадра.	0.000…1.000
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox
redetectScoreThreshold	Задает минимальную оценку точности повторной детекции ТС. Увеличение значения уменьшает количество ложноположительных результатов повторной детекции.	0.000…1.000 (по умолчанию — 0.25)
redetectOneNMSThreshold	Задает порог алгоритма NMS, используемый на первом этапе повторной детекции. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.4)
redetectNMSThreshold	Задает дополнительный порог алгоритма NMS для повторной детекции ТС. Увеличение значения повышает вероятность обнаружения частично перекрытых ТС, но также увеличивает количество ложноположительных детекций.	0.000…1.000 (по умолчанию — 0.5)
redetectNMS	Задает режим работы алгоритма подавления пересекающихся BBox при повторной детекции ТС. Параметр влияет на точность определения положения ТС в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox

VehicleDetectorV7 — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
ScoreThreshold	Задает минимальную оценку точности детекции ТС. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных ТС.	0.000…1.000
alignment	Задает выравнивание размеров входного изображения. Параметр используется только при squareFormat = 0. При обработке изображение дополняется черными полями до заданного размера по высоте или ширине. Использование параметра повышает производительность пакетной обработки. Значение должно быть равно степени двойки (2, 4, 8, 16, …).	2…512
maxFlowerBatchSize	Задает максимальное количество изображений, одновременно передаваемых на inference.	1…16

Детектор PlateDetectorV5

PlateDetectorV5 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
ScoreThreshold	Задает минимальную оценку точности детекции ГРЗ. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных ГРЗ.	0.000…1.000
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции ГРЗ. Увеличение значения повышает вероятность обнаружения небольших ГРЗ на крупных ТС, но увеличивает время обработки.	200…440
maxFlowerBatchSize	Задает максимальное количество изображений, одновременно передаваемых на inference.	1…16
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения ГРЗ, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
SecondNMSThreshold	Задает дополнительный порог алгоритма NMS для выполнения повторной обработки. Значение должно быть больше NMSThreshold. Увеличение значения позволяет снизить количество ложноположительных детекций.	0.000…1.000
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника ГРЗ. Параметр влияет на точность определения положения ГРЗ в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox
detectionToFrameRatioThreshold	Задает порог отношения площади детекции к площади кадра.	0.000…1.000

Детектор SmokeFireDetectorV1

SmokeFireDetectorV1 — параметры, разрешенные к изменению

Параметр	Описание	Возможные значения
	Разрешено изменять
ScoreThreshold	Задает минимальную оценку точности детекции дыма и огня. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных случаев обнаружения дыма и огня.	0.000…1.000

Детектор AnimalDetectorV1

AnimalDetectorV1 — параметры, запрещенные к изменению

Параметр	Описание	Возможные значения
	Запрещено изменять
minSize	Задает минимальный размер детекции. Детекции меньшего размера не возвращаются в ответе и не используются при дальнейшей обработке. Параметр имеет фиксированное значение и не подлежит изменению.	—

AnimalDetectorV1 — параметры, не рекомендуемые к изменению

Параметр	Описание	Возможные значения
	Не рекомендуется изменять
ScoreThreshold	Задает минимальную оценку точности детекции животных. Увеличение значения уменьшает количество ложноположительных детекций, но увеличивает количество пропущенных животных.	0.000…1.000
NMSThreshold	Задает порог алгоритма NMS. Увеличение значения повышает вероятность обнаружения животных, частично перекрытых другими объектами, но также увеличивает количество ложноположительных детекций.	0.000…1.000
imageSize	Задает размер изображения по большей стороне (в пикселях), используемый для детекции животных. Увеличение значения повышает вероятность обнаружения небольших животных, но увеличивает время обработки.	320…1280
nms	Задает режим работы алгоритма подавления пересекающихся BBox при выборе наиболее подходящего ограничивающего прямоугольника животного. Параметр влияет на точность определения положения животного в кадре. Повышение точности может привести к снижению производительности.	best — выбирается BBox с максимальным пересечением с другими BBox; mean — результирующий BBox определяется усреднением координат всех пересекающихся BBox