Go to documentation repository
To configure the License plate recognition XR detector, do the following:
By default, the detector is enabled and set to recognize vehicle license plates.
If necessary, you can change the detector parameters. The list of parameters is given in the table:
| Parameter | Value | Description |
|---|---|---|
| Object features | ||
| Video stream | Main stream | If the camera supports multistreaming, select the stream for which detection is needed. Selecting a low-quality video stream reduces the load on the server. |
| Check in lists | Yes | The Check in lists parameter is disabled by default. If you want to use this detector to check in lists of vehicle license plates, select the Yes value (see Checking in lists of LPs) |
| No | ||
| Object identification | ||
| Name | License plate recognition XR | Enter the detector name or leave the default name |
| Enable | Yes | The detector is enabled by default. To disable the detector, select the No value |
| No | ||
| Type | License plate recognition XR | Name of the detector type (non-editable field) |
| Decoder mode | Auto | Select a processing resource for decoding video streams. When you select a GPU, a stand-alone graphics card takes priority (when decoding with NVIDIA NVDEC chips). If there is no appropriate GPU, the decoding will use the Intel Quick Sync Video technology. Otherwise, CPU resources will be used for decoding |
| CPU | ||
| GPU | ||
| HuaweiNPU | ||
| Basic settings | ||
| Algorithm for detecting vehicle direction | By LP coordinates | The By LP coordinates algorithm is used by default. It works as follows: if the coordinates of the vehicle license plate shift from top to bottom (the vehicle moves towards the camera) and if the coordinates of the vehicle license plate shift from bottom to top (the vehicle moves away from the camera). Select the By vehicle scale change parameter if in the Surveillance window, the scale of the vehicle license plate increases (the vehicle moves towards the camera) and if the scale of the vehicle license plate decreases (the vehicle moves away from the camera) |
| By vehicle scale change | ||
| Frame size change | 1920 | The analyzed frames are scaled down to a specified resolution (1920 pixels on the longer side) by default. The value must be in the range [640, 10000]. The following algorithm is used:
Note For example, the source image resolution is 2048*1536, and the specified value is set to 1000. In this case, the source resolution will be halved two times (512*384), as after the first division, the number of pixels on the longer side exceeds the specified value (1024 > 1000). If detection is performed on a higher resolution stream and detection errors occur, we recommend reducing the compression. |
| Initiate event in (sec) | 0 | Specify the time in seconds after which an event must be generated after recognizing a license plate in the frame. The value must be in the range [0, 60] Effect of values:
Recommendations:
Impact on resources:
|
| LP recognition basic settings | ||
| Countries | (Select all), Afghanistan, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia, Botswana, Brazil, Brunei, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, Chine, Christmas Island, Cocos Isands, Colombia, Comoros, Congo, Cook Islands, Costa Rica, Croatia, Cuba, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Fiji, Finland, France, French Guiana, French Polynesia, French Southern Territories, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Great Britain, Greece, Greenland, Grenada, Guadeloupe, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Ivory Coast, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Kosovo, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Micronesia, Moldova, Monaco, Mongolia, Montenegro, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Netherlands, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, North Korea, Northern Mariana Islands, Norway, Oman, Pakistan, Palau, Palestine, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Island, Poland, Portugal, Puerto Rico, Qatar, Reunion Island, Romania, Russia, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and the Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, South Korea, South Sudan, Suriname, Spain, Sri Lanka, Swaziland, Sweden, Switzerland, Syria, Taiwan, Tajikistan, Tanzania, Thailand, Tibet, Timor Leste, Togo, Tokelau, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Vatican, Venezuela, Vietnam, Virgin Islands British, Virgin Islands USA, Wallis and Futuna Islands, Western Sahara, Yemen, Zambia, Zimbabwe | The Not used value is selected by default. In the window that opens, set one or several checkboxes next to the countries whose license plates must be recognized. Click the Apply button. To cancel the selection of countries, click the Cancel button |
| Country name 1 (deprecated) | (Not used), Afghanistan, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antarctica, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia, Botswana, Brazil, Brunei, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, Chine, Christmas Island, Cocos Isands, Colombia, Comoros, Congo, Cook Islands, Costa Rica, Croatia, Cuba, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Fiji, Finland, France, French Guiana, French Polynesia, French Southern Territories, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Great Britain, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Ivory Coast, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Kosovo, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Micronesia, Moldova, Monaco, Mongolia, Montenegro, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Netherlands, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, North Korea, Northern Mariana Islands, Norway, Oman, Pakistan, Palau, Palestine, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Island, Poland, Portugal, Puerto Rico, Qatar, Reunion Island, Romania, Russia, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and the Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, South Korea, South Sudan, Suriname, Spain, Sri Lanka, Sudan, Swaziland, Sweden, Switzerland, Syria, Taiwan, Tajikistan, Tanzania, Thailand, Tibet, Timor Leste, Togo, Tokelau, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Vatican, Venezuela, Vietnam, Virgin Islands British, Virgin Islands USA, Wallis and Futuna Islands, Western Sahara, Yemen, Zambia, Zimbabwe | Attention! Starting with Detector Pack 3.17.1, this parameter is deprecated. Its value is only taken into account if you select the Not used value in the Countries parameter. Otherwise, this parameter is ignored. Albania is selected by default. From the drop-down list, select one country whose license plates are actually found in the detection area and which need to be recognized
|
| Country name 2 (deprecated) | ||
| Country name 3 (deprecated) | ||
| Country name 4 (deprecated) | ||
| Country name 5 (deprecated) | ||
| LP recognition advanced settings | ||
| Period of ignoring repeated recognitions (sec) | 0 | Specify the period of time in seconds during which repeatedly recognized license plates are ignored. The value must be in the range [0, 86400]. Effect of values:
Recommendations:
Impact on resources:
|
| Maximum Levenshtein distance | 1 | Specify the maximum Levenshtein distance between license plate characters. The value must be in the range [0, 999]. This parameter is used to determine what makes a license plate different from the previous license plate (Levenshtein distance). For two identical readings, the Levenshtein distance is zero. This parameter helps to reduce false positives when a license plate is read several times before a result is given and a partial reading still represents a valid license plate. Example: real license plate is "AB-4567".
If the maximum distance is set to 0 (exact match), the system reports two license plates. But if the distance is set to 1 (or greater), the system reports the first license plate, but not the second one. This is because a license plate with one distinct character is considered a readout of the same license plate, that is, a probable misreading has occurred Note
|
| Minimum height of license plate characters (pixels) | 14 | Specify the minimum height of license plate characters in pixels. This is the distance between the top pixel of the character and the bottom pixel. The value must be in the range [14, 70] |
| Maximum height of license plate characters (pixels) | 70 | Specify the maximum height of license plate characters in pixels. The value must be equal to or greater than the value in the Minimum height of license plate characters (pixels) parameter. The value must be in the range [34, 70] Note
|
| Minimum authenticity threshold | 80 | Specify the minimum value of recognition authenticity as a percentage. The value must be in the range [1, 100]. The parameter determines the minimum average confidence level of all characters of a license plate. If the average value of all characters has a confidence level below the set threshold, the entire license plate is rejected and no event is generated Effect of values:
Difference from the Minimum character confidence threshold parameter
Recommendations:
Impact on resources:
|
| Minimum character confidence threshold | 80 | Specify the minimum threshold value of license plate recognition confidence as a percentage. The value must be in the range [1, 100]. The parameter determines the minimum level of recognition confidence for each individual character of the license plate. If at least one character has a confidence level below the set threshold, the entire license plate is rejected and no event is generated. Effect of values:
Recommendations:
Impact on resources:
|
| Country pattern compliance | Yes | The parameter is enabled by default. To disable the check of country pattern compliance, select the No value |
| No | ||
| Extra processing for LP search | Yes | The parameter is disabled by default. To enable the extra processing for license plate search, select the Yes value Effect of values:
Recommendations:
Impact on resources:
|
| No | ||
| Minimum number of characters in LP | 2 | Specify the minimum number of characters in a license plate. The value must be in the range [2, 16] |
| Maximum LP slope angle | 40 | Specify the maximum slope angle of the license plate. The value must be in the range [0, 999] |
| Recognition algorithm complexity | Low level | Select the complexity level of recognition algorithm from the list. The Medium level is selected by default Note
|
| Medium level | ||
| High level | ||
| Minimum number of same LP readings | 1 | Specify the minimum number of readings of the same license plate. For example, if you set the value to 2, you will receive a massage about a license plate only if two identical readings have been made. The value must be in the range [1, 999]. Effect of values:
Recommendations:
Impact on resources:
|
| Maximum number of same LP readings | 10 | Specify the maximum number of readings of the same license plate. The value must be in the range [1, 999]. When the set limit is reached, the result is returned immediately, without waiting for the timeout to expire. Effect of values:
Recommendations:
Impact on resources:
|
| Recognition timeout (sec) | 0 | Specify the recognition timeout in seconds. The value must be in the range [0, 999]. The parameter determines the period during which multiple readings of the same license plate are accumulated before the final decision is made. After the timeout, the system selects the best result from all accumulated readings. Effect of values:
Interaction with the Maximum/Minimum number of same LP readings parameters
Recommendations:
Impact on resources:
|
| Vehicle recognition basic settings | ||
| Vehicle recognition | Yes | The parameter is disabled by default. To enable the vehicle recognition, select the Yes value |
| No | ||
| Vehicle recognition advanced settings | ||
| Minimum vehicle recognition confidence threshold | 50 | Specify the threshold value of the minimum vehicle recognition confidence as a percentage. The value must be in the range [1, 100] |
| Vehicle analytics quality | Medium level | Select the quality of the vehicle analysis from the list. The Medium level is selected by default |
| High level | ||
| Maximum level | ||
By default, the entire frame is analyzed. If you want to analyze only a part of a frame, in the surveillance window, specify the area in which detection and recognition of vehicles will be performed. You can adjust the area by moving the anchor points .
Note
To save the parameters of the detector, click the Apply button. To cancel the changes, click the Cancel button.
Configuration of the License plate recognition XR is complete.