Skip to content

Appendix 2. 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; 3
- 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. - VehicleDetectorV1; VehicleDetectorV4
- VehicleDetectorV2;
- VehicleDetectorV2Large;
- VehicleDetectorV3;
- VehicleDetectorV4
defaultPlateDetectorType LP detector by default - PlateDetectorV1; PlateDetectorV4
- PlateDetectorV2;
- PlateDetectorV3;
- PlateDetectorV4
defaultAnimalDetectorType Animals detctor by default AnimalDetectorV1 AnimalDetectorV1
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; V2 V1
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 - CIS_ATTRS_V1; V3
- CIS_ATTRS_V2;
- V3
Detector VehicleDetectorV1
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.8
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting a vehicle blocked by objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.35
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 this will increase the processing time. If it is necessary to detect a large number of small objects, it is recommended to use the VehicleDetectorV2Large detector. 480…840 640
redetectImageSize The size of the image in pixels along the larger side, on which the vehicle is redetected. 320...1280 320
redetectExpandCoeff Image scaling factor. 1.000…2.000 1.5
nms Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector VehicleDetectorV2
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.3
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 this will increase the processing time. If it is necessary to detect a large number of small objects, it is recommended to use the VehicleDetectorV2Large detector. 480…840 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 theoretically, 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.
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting a vehicle 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. Increasing the value will reduce the number of false positive detections. 0.000…1.000 0.8
nms Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
redetectScoreThreshold Threshold for estimation of vehicle redetection accuracy. Increasing the threshold reduces the number of false negative detection results. 0.000…1.000 0.1
redetectImageSize The size of the image in pixels along the larger side, 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 scaling factor. 1.000…2.000 1.5714285714285714
redetectNMS Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector VehicleDetectorV2Large
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.3
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 this will increase the processing time. If it is necessary to detect a large number of small objects, it is recommended to use the VehicleDetectorV2Large detector. 1280...2560 1280
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting a vehicle 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. Increasing the value will reduce the number of false positive detections. 0.000…1.000 0.8
nms Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
redetectScoreThreshold Threshold for estimation of vehicle redetection accuracy. Increasing the threshold reduces the number of false negative detection results. 0.000…1.000 0.1
redetectImageSize The size of the image in pixels along the larger side, 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 scaling factor.. 1.000…2.000 1.5714285714285714
redetectNMS Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector VehicleDetectorV3
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.3
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 this will increase the processing time. If it is necessary to detect a large number of small objects, it is recommended to use the VehicleDetectorV2Large detector. 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 theoretically, 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 vehicle 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. Increasing the value will reduce the number of false positive detections. 0.000…1.000 0.8
nms Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
redetectScoreThreshold Threshold for estimation of vehicle redetection accuracy. Increasing the threshold reduces the number of false negative detection results. 0.000…1.000 0.1
redetectImageSize The size of the image in pixels along the larger side, 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 scaling factor.. 1.000…2.000 1.5714285714285714
redetectNMS Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
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 this will increase the processing time. If it is necessary to detect a large number of small objects, it is recommended to use the VehicleDetectorV2Large detector. 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 theoretically, 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 vehicle 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. Increasing the value will reduce the number of false positive detections. 0.000…1.000 0.8
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 Parameter affecting the accuracy of vehicle localization on the frame. Higher accuracy, reduces performance. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
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 image in pixels along the larger side, 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 scaling 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 – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector PlateDetectorV1
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.7
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.3
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. 320...1280 640
redetectImageSize The size of the image in pixels along the larger side, on which the LP is redetected. 320…1280 320
redetectExpandCoeff Image scaling factor.. 1.000…2.000 1.4375
nms A parameter that affects the accuracy of localization of the LP on the frame. The higher the accuracy, the lower the speed. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector PlateDetectorV2
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.7
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. 320...1280 320
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.
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.3
SecondNMSThreshold Rechecking the non-maximum suppression threshold, with a larger value. Increasing the value will reduce the number of false positive detections. 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 – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector PlateDetectorV3
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.3
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. 320...1280 320
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; 1
- 1 – off.
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.3
SecondNMSThreshold Rechecking the non-maximum suppression threshold, with a larger value. Increasing the value will reduce the number of false positive detections. 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 – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Detector PlateDetectorV4
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.30
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. 320...1280 320
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; 1
- 1 – off.
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.3
SecondNMSThreshold Rechecking the non-maximum suppression threshold, with a larger value. Increasing the value will reduce the number of false positive detections. 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 – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – the mode in which the best BBox is determined by averaging the values of all intersecting BBoxes
Детектор AnimalDetectorV1
ScoreThreshold Animal 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.65
NMSThreshold Threshold value for non-maximum suppression. The higher the threshold, the higher the probability of detecting an animal blocked by other objects. Increasing the threshold will increase the number of false positive detections. 0.000…1.000 0.45
imageSize The size of the image in pixels along the larger side, on which the animal is detected. Increasing the size will allow better detection of small animals, but it will increase the processing time. 320...1280 512
nms A parameter that affects the accuracy of localization of the animal on the frame. The higher the accuracy, the lower the speed. - best – the mode in which the best BBox is the one whose intersection with other BBoxes has the maximum value; mean
- mean – режим, при котором лучший BBox определяется усреднением значений всех
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