Module setup🔗

Warning

This module uses additional libraries that are not included in the basic Eocortex distribution package. Before configuring and using the module, it is necessary to install these libraries on the server to which the cameras selected for recognition are connected. After installation, an additional license key must be activated on this server to license the module.

Warning

Only one of the License Plate Recognition modules can be installed on the same server: either License Plate Recognition (Complete) or License Plate Recognition (Light).

To use the module, enable and set up the software motion detector, then activate the module itself.

Launch the Eocortex Configurator, go to the /config/svg/ico-tab-cams.png Cameras tab, select a camera in the list located on the left side of the page, and set up the motion detector on the Motion detector tab on the right side of the page.

Then switch to the Analytics tab and enable the module using the /svg/ico-switch-on.png toggle.

../../_images/module-turn8.png

Clicking the /config/svg/ico-settings.png button opens the module setup window.

Warning

In the software motion detector settings, the minimum width and height of the object must be smaller than the dimensions of a vehicle.

Additionally, it is recommended to set the whole frame as the detection area for the software motion detector to ensure reliable recognition.

The right bottom corner of the module settings window contains the version of the SDK libraries used by the License plate recognition module.

The module settings are described below.

Basic settings

The settings of the license plate recognition can be set on the Basic settings tab.

../../_images/lpr-complete-configure-recognition.png

Specify countries: opens a window where license plates and countries that should be recognized can be selected.

../../_images/lpr-complete-configure-countries.png

In the window that opens, mark the countries whose license plates should be recognized and select license plate templates for each selected country. Unmarked countries and templates will not be recognized.

Warning

The empty list of countries means that the Licence plate recognition (Complete) module is not installed, or that errors occurred during its installation, or that there is no protection key, or its activation encountered problems.

Warning

The more countries and samples have been selected for recognition, the higher the computing load on the server. When the processor load exceeds 80%, the recognition quality may drop significantly.

Set the size range of a license plate opens the window of setting the minimum and maximum width of the license plates to be recognized.

../../_images/lpr-complete-configure-recognition-size.png

License plate search zone opens the window of setting up the zones of the frame where the license plate numbers to be recognized will appear.

../../_images/lpr-complete-configure-recognition-zone.png

For creating a new zone, it is required to press the left mouse button and, holding it, select a rectangular area. The total area uniting all the set zones will be used for recognition. To delete the zone, click on the close icon in the upper right corner of the zone.

Quality of recognition is the internal parameter of the module’s operation. It sets the filtering by the quality of recognition, meaning that the license plates the reliability of whose recognition is lower than a preset value will be automatically discarded. The value of this parameter shall be selected tentatively: when it is higher, the reliability of the recognized numbers will be higher, but the total quantity of the recognized numbers will be smaller; when it is lower, the quantity of the recognized numbers will be larger, but the number of recognition mistakes will increase.

The Acceptable number of unrecognized characters setting filters the license plate numbers by the quantity of the unrecognized symbols: the plates where the number of unrecognized symbols is bigger than the preset value will be automatically discarded.

Use neural network for searching for license plate numbers: Enabling this option allows to increase accuracy of searching for number plates. However, the server load from the given camera will increase 50% approx.

Use neural network for recognizing license plate numbers: Enabling this option will increase accuracy of license plate symbols' recognition. However, the load on the server from the given camera will increase 50% approx.

Enable in-depth analysis: Enabling this option allows to improve license plate recognition accuracy under unfavorable conditions, e.g. when the camera's parameters are not in complete conformance with the relevant requirements, or when the weather conditions are poor. Using this option leads to the increase of the frame processing time of 20 to 30%. Under normal conditions, this parameter has no effect on the recognition quality.

Enable license plate recognition taking perspective into account: allows to make allowance for a perspective distortion.

Enable more thorough search in the specified range of sizes: Enabling this option allows to improve recognition accuracy in a case when the difference between the minimum and the maximum dimensions of the license plate number is very big (more that three times). In this case, the load on the server from the given camera will increase 30% approx.

Limit the license plate re-recognition time, sec.: allows to set the period of timefrom the initial recognition of the plate number, during which no attempts will be made to recognize the same number.

Note

This setting may be useful, for example, for the situations involving the automatic opening of a rising arm barrier, when the vehicle stops before the barrier and the module may attempt to recognize its license plate one more time after the vehicle starts to move again. Such repeated recognition may also happen when the license plate was temporarily blocked by some object.

Direction of movement: enabling this option allows to configure the definition of the movement direction of the plate on the camera frame. After enabling this option, it is needed to set the entry direction by clicking the Entrance direction link and selecting the arrow in the window that opens. At the same time, vehicles moving in the opposite direction will be considered as driving out.

../../_images/lpr-complete-configure-direction.png

Additional: Allows importing and exporting settings of the license plate recognition module.

Save frames to disc: Allows saving frames with detected license plates to a folder on the server.

../../_images/lpr-complete-configure-save-frame-option.png

The option must be configured after enabling by clicking the Adjust saving link.

../../_images/lpr-complete-configure-save-frame-settings.png

In the window that opens, specify the path to the directory where the frames should be stored, as well as its maximum size.

Parking spots

On the Parking spots tab, settings for parking lots can be made.

../../_images/lpr-complete-configure-parking.png

To access the settings for parking lots, turn on the Track parking lots slider.

Note

Parking lot settings are set for the entire system.

The following actions can be performed in the settings window:

  • create a new parking lot;

  • edit or delete an existing parking lot.

The following settings can be set for a parking lot:

  • name;

  • one or more cameras working as entry and exit points;

  • permissible parking time;

  • number of parking spots;

  • period and time of resetting the counter.

../../_images/lpr-complete-configure-parking-zone.png

The following events were added to the Tasks by event tab of the Automation section:

  • Parking vehicle counter has been changed

  • Parking event

  • Parking lot occupancy has changed

A new user right, Adjusting the number of occupied parking spots, has been added to the Users section. This right allows the user to change the value of the occupied parking spots counter in the Eocortex Client application. By default, this right is enabled.

Database

The access to the license plate database can be set on the Database tab.

../../_images/lpr-complete-configure-database.png

Two database deployment options are available: Local or Remote.

If the recognition process runs on only one server, it is recommended deploying the database on this server by selecting Local.

If the recognition process is running on several servers, the database should still be hosted only on one of them. For this purpose, select the Remote option for all cameras and specify the database connection parameters: server address, name and password of the database administrator. The same applies when the database of the module is deployed on one server, and the camera with the module enabled is attached to another one.

Note

Eocortex version 3.6 and lower uses Firebird DBMS with the following default values:

  • Port: 3050

  • Username: SYSDBA

  • Password: masterkey

Note

Starting from version Eocortex 4.0, the module's database is handed over to the PostgreSQL DBMS with the following default values:

  • Port: 5432

  • Username:

    • For Windows: postgres

    • For Linux: eocortex

  • Password: masterkey

Warning

Remote access to databases is not allowed by default in PostgreSQL and must be additionally configured if remote databases are used for analytics. All settings must be done for the server where the database is stored. Settings are slightly different for Windows and Linux operating systems.

When the server is running for the first time after upgrading Eocortex to version 4.0 or higher, the existing module database will be automatically transformed to be compatible with PostgreSQL.

Warning

If connecting to a Remote database, use the DBMS Username and Password that are valid for the server storing the database.

Warning

Independent of the database location, the recognition events (date and time of recognition, coordinates of the object in the frame, binding of the recognized object to the database) will always be stored on the server to which the camera with the corresponding events is bound.

Warning

Synchronization with the database located on a remote server can take some time

Note

When using a remote database, the remote database replication mechanism will be applied.

It is possible to check the availability of the database clicking the Connection check link. If the server is unavailable, the corresponding message will be displayed.

The Database identifier field sets its own license plate database for an individual camera or groups of cameras.

Warning

The field Database identifier is not initially displayed at the launch of the module.

Note

To use this capability, it is required to set Database identifier via REST API.

Barrier gate control

The settings of the module’s interaction with a rising arm barrier can be made on the Barrier gate control tab.

../../_images/lpr-complete-configure-barrier.png

The Rising arm barrier control mode must be activated to access the settings of the module’s interaction with a rising arm barrier.

Note

To use the module only for controlling a rising arm barrier, the Licence plate recognition (Complete) module license or protection key is not required. However, for ensuring the abovementioned functionality, it is necessary to have the Licence plate recognition (Complete) module support indicated in the Eocortex license file or software key for the corresponding quantity of cameras.

When the rising arm barrier control mode is activated, the following capabilities are available:

Control methods:

  • Manual control: allows the operator to open and close the barrier using the Eocortex Client application.

  • Auto (by recognized license plate): allows to open the rising arm barrier automatically if the recognized number is in the white list, i.e. is included in the group of vehicles for which the automatic opening of the barrier is envisioned.

In case the automatic rising arm barrier control is activated, the following options are available:

  • Open the barrier: if the recognized number is in the white list, the Eocortex server generates a command to open the barrier.

  • Open and close: if the recognized number is in the white list, the Eocortex server generates a command to open the barrier; then, in a number of seconds set in the Close after opening in (sec) field, a command for closing the barrier is generated.

Note

Most of the modern rising arm barriers automatically close after the passing of one vehicle. For such barriers, the Open the barrier option shall be selected.

Warning

When the Open and close option is selected, it is imperative that the barrier itself has a feature of preventing its closing when a car is below the rising arm. It means that after generating the closing command the barrier’s automatics must check if there is a vehicle or a person on the line of closing, and proceed with the closing only in the absence of the above.

Note

Both in manual and in automatic barrier control mode, the opening or closing command is understood as the generation of the Request to open rising arm barrier or Request to close rising arm barrier event, correspondingly. To control the rising arm barrier, it is required to set the actions for these events depending on the control wiring diagram of the particular barrier.

Note

For the License Plate Recognition (Complete) module, the following types of Automatic reports can be configured: License plate recognition, Entry/exit time recording, Vehicle counting.

Warning

The module will start working only when the settings are applied.

Related references