Skip to content

Appendix 4. Description of the parameters of the configuration file «vehicleEngine.conf»#

Parameter Description Possible values Default values Editing recommendation
General parameters
logSeverity The parameter sets the logging mode of the VehicleEngine. - 4 – logging debug information; 4
- 3 - logging information about work plus information for 4;
- 2 – logging warning record plus information for 3;
- 1 – logging error record plus information for 2;
- 0 – disable logging;
defaultVehicleDetectorType Vehicle detector by default. For more details on detectors, see section 4.2.1. VehicleDetectorV4 VehicleDetectorV4
defaultPlateDetectorType LP detector by default. For more details on detectors, see section 4.2.2. PlateDetectorV5 PlateDetectorV5
defaultAggregatedPlateAttributesEstimatorType Aggregated LP attributes estimator type. Each version contains a specific set of countries for estimating LP. For more information, see the plate_aggregated_v1.conf and plate_aggregated_v2.conf configuration files in the CARS API delivery. - V1 V1
- V2
defaultCountryPlateEstimatorType Version of the algorithm for estimating the accuracy of recognition of the LP country. Each version of the algorithm contains a specific set of countries to estimate. For more information, see the grz_country_recognition_*.conf files in the CARS API delivery V4 V4
Detector VehicleDetectorV4
ScoreThreshold Vehicle detection accuracy threshold. Increasing the threshold reduces the number of false positive detections but increases the number of false negative detection (misses). 0.000…1.000 0.50
imageSize The size of the image in pixels on the larger side on which the vehicle is detected. Increasing the size will allow better detection of vehicles in the background, but it will increase the processing time. 320...1280 640
minInputSize Minimum image size for inference. Measured in pixels. The parameter value must be strictly less than the imageSize value. This parameter is selected theoretycally, has one default value and must not be changed by users. - 40
squareFormat Enable Square Format - Automatically adds black bars to the edges of a rectangular frame to create a square frame. Turning it on will increase image processing time. - 0 – on 0
- 1 – off
alignment If squareFormat = 0 then if possible width or height of the input image will be aligned up to this value, extra space will be filled with black pixels. This parameter is needed for better batching utilization. The parameter value should be 2 to the nth degree (i.e. 2/4/8/16/...). 2...512 64
maxFlowerBatchSize Maximum number of images used for inference at once. 1...16 16
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting a LP blocked by objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.4
SecondNMSThreshold Rechecking the non-maximum suppression threshold, with a larger value. This is necessary to obtain an increase in the number of true positive detection results. 0.000…1.000 1.0
minSize Minimal size of detection. Detections of a smaller size will not be returned to the user and will not be used for the further processing. This parameter is selected theoretically, has one default value and must not be changed by users. - 20
nms A parameter that affects the accuracy of localization of the LP on the frame. The higher the accuracy, the lower the speed. - best – simplified mode of operation; mean
- mean – enhanced precision mode.
redetectScoreThreshold Threshold for estimation of vehicle redetection accuracy. Increasing the threshold reduces the number of false negative detection results. 0.000…1.000 0.25
redetectImageSize The size of the side of the square image in pixels, on which the vehicle is redetected. 100...1280 150
redetectOneNMSThreshold The value of the non-maximum suppression threshold for vehicle redetection. The higher the threshold, the higher the probability of repeated detection of a vehicle blocked by objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.4
redetectNMSThreshold The value of the non-maximum suppression threshold for vehicle redetection. The higher the threshold, the higher the probability of repeated detection of a vehicle blocked by objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.5
redetectExpandCoeff Image scale factor. 1.000…2.000 1.4375
redetectSquareThreshold The threshold value for skipping redetections by area. Redetections whose area is less than the specified threshold are not used for further work.
The parameter value is derived theoretically and cannot be changed - 3.25
redetectNMS Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – simplified mode of operation; mean
- mean – enhanced precision mode.
Detector PlateDetectorV5
ScoreThreshold LP detection accuracy threshold. Increasing the threshold reduces the number of false positive detections but increases the number of false negative detection (misses). 0.000…1.000 0.50
imageSize The size of the image in pixels along the larger side, on which the LP is detected. Increasing the size will allow better detection of small LPs on larger vehicles, but it will increase the processing time. 220...1280 220
maxFlowerBatchSize Maximum number of images used for inference at once. 1...16 16
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting a LP blocked by objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.35
SecondNMSThreshold Rechecking the non-maximum suppression threshold, with a larger value. This is necessary to obtain an increase in the number of true positive detection results. 0.000…1.000 1.0
nms A parameter that affects the accuracy of localization of the LP on the frame. The higher the accuracy, the lower the speed. - best – simplified mode of operation; best
- mean – enhanced precision mode.
Detector SmokeFireDetectorV1
ScoreThreshold Threshold for estimation of the detection accuracy of smoke and fire. Increasing the threshold reduces the number of false positive detections but increases the number of false negative detection (misses). 0.000…1.000 0.5
Detector AnimalDetectorV1
ScoreThreshold Threshold for estimation of the detection accuracy of an animal. Increasing the threshold reduces the number of false positive detections but increases the number of false negative detection (misses). 0.000…1.000 0.65
NMSThreshold Значение порога параметра nms. Чем больше порог, тем выше вероятность детекции животного перекрытого другими объектами (не являющимися объектами интереса). При увеличении порога возрастет количество ложноположительных детекций 0.000…1.000 0.45
imageSize Размер изображения в пикселях по большей стороне, на котором происходит детекция животного. Увеличения размера позволит лучше детектировать маленьких животных, но это увеличит время обработки 320...1280 512
nms Parameter that affects the accuracy of localization of the animal on the frame. The higher the accuracy, the lower the speed. - best – simplified mode of operation; best
- mean – enhanced precision mode.
minSize Minimal size of detection. Detections of a smaller size will not be returned to the user and will not be used for the further processing. This parameter is selected theoretically, has one default value and must not be changed by users. - 16