License plate recognition technology embedded in AXIS camera

Transcripción

VaxALPR On Camera
User Manual 1.9.5
License plate recognition technology
embedded in AXIS camera
User Manual
Version 1.9.5
VaxALPR On Camera User Manual
Version 1.9.5 – September 2016
VAXTOR SYSTEMS. Ronda de Poniente 15, 1º. Tres Cantos – SPAIN
Phone number: +34 91 757 22 11 -- e-mail: [email protected] – web: http://www.vaxtor.com
1
VaxALPR On Camera
User Manual 1.9.5
Table of Contents
1.
About VaxALPR On Camera................................................................................................... 3
2.
Product installation ............................................................................................................... 3
3.
License ................................................................................................................................... 5
4.
Setup quick guide .................................................................................................................. 8
5.
Settings .................................................................................................................................. 9
5.1
Country Options .......................................................................................................... 11
5.2
Environment Options .................................................................................................. 12
5.3
OCR Options ................................................................................................................ 14
5.3.1
Triggered Options ................................................................................................ 14
5.4
Reporting Options ....................................................................................................... 14
6.
Region of interest configuration (ROI) ................................................................................ 17
7.
Blacklist and whitelist configuration ................................................................................... 18
7.1
Add a new plate .......................................................................................................... 18
7.2
Modify the description of a plate ................................................................................ 18
7.3
Delete a plate .............................................................................................................. 19
7.4
Delete the list from the camera .................................................................................. 19
7.5
Export to a XML file ..................................................................................................... 19
7.6
Import from a CSV file ................................................................................................. 20
8.
VaxALPR On Camera Viewer ............................................................................................... 22
9.
Integration with Axis Camera Station ................................................................................. 23
9.1
Requisites .................................................................................................................... 23
9.2
Capturing events from VaxALPR On Camera .............................................................. 23
10.
Tips and basic troubleshooting guide ............................................................................. 28
11.
Developers area .............................................................................................................. 30
11.1 VaxALPR On Camera events definition ....................................................................... 30
11.1.1 ALPR event declaration ....................................................................................... 30
11.1.2 Blacklist event ..................................................................................................... 32
11.1.3 Whitelist event .................................................................................................... 33
11.2
Proprietary event format ............................................................................................ 34
11.3
HTTP POST Format ...................................................................................................... 36
2
VaxALPR On Camera
User Manual 1.9.5
1. About VaxALPR On Camera
VaxALPR On Camera is a real-time solution for automatic license plate recognition (ALPR) with
multi-country support.
The product can be installed in all the AXIS cameras with ARTPEC-4 or ARTPEC-5 chips. The
analytics run entirely within the camera, thus no PC is required even for the setup.
VaxALPR On Camera is available for parking, low speed free-flow or high speed triggered
environments. Results are published through the network under VAPIX/ONVIF protocols, HTTP
POST or open proprietary format among other mechanisms described in this manual.
2. Product installation
1. Connect with the camera and select “Applications” at the menu on the left.
Axis Main Configuration page
Important: VaxALPR On Camera requires a license file. Trial licenses are available, please check
section 3 or contact with Vaxtor Systems to request one.
Web: http://www.vaxtor.com
3
VaxALPR On Camera
User Manual 1.9.5
2. Deploy VaxALPR On Camera application.
Deploy menu


Press the button “Select file” and select the package file provided by Vaxtor Systems
(VaxALPR_On_Camera_1_9_5.eap). Ensure to upload the latest application available at
http://www.vaxtor.es/vaxalpr-axis.html.
Press “Upload package” to deploy the application.
The next image shows the application correctly deployed.
VaxALPR On Camera deployed
If there is an error on the deploy operation:
4
VaxALPR On Camera
User Manual 1.9.5
-
-
Check that the file has been correctly downloaded from the Vaxtor website. An MD5
sum will be published with each new version. You can use Certutil.exe application in
Microsoft Windows to calculate the MD5 of the file
(https://technet.microsoft.com/en-us/library/cc732443(v=ws.11).aspx).
Upgrade to the latest firmware available for the Axis camera.
3. License
VaxALPR On Camera requires a license file to run correctly. To acquire a valid license, you can
contact Vaxtor Systems or download a trial license valid for 30 days from Axis website (a valid
Axis account will be needed). To download a valid license:
1. Select “Application->VaxALPR On Camera->License” on the left menu. Take note of the
device serial number that appear on the “Manual Installation” bullet and click on the
www.axis.com link.
2. A new browser window will open with the axis website. Login with your Axis account or
create a new account. Once logged you will be redirected to the “License key registration”
webpage.
5
VaxALPR On Camera
User Manual 1.9.5
3. Insert your camera serial number.
4. Select “I do not have a license code” to download a trial license. If you have a license
code for a permanent license insert it here.
5. Select the application VaxALPR On Camera.
6. Press “Generate”. A valid license file will be downloaded.
Once you have a valid license file:
1. Select “Application->VaxALPR On Camera->License” on the left menu. Press the button
“Select file” and select the license file provided by Vaxtor Systems.
2. Press the button “Install”.
License options
6
VaxALPR On Camera
User Manual 1.9.5
The next image shows the license installed.
License installed
To ensure that the installation has been done correctly, select the option “Applications ->
Overview” on the left menu. The license column will have the value “Valid”.
Press “Start” button to run the application. The Status column will have the value “Running”.
License validation view
7
VaxALPR On Camera
User Manual 1.9.5
4. Setup quick guide
By default, VaxALPR On Camera default parameters are set to recognize license plates in most
scenarios. To start the application, follow the next steps:
1.
2.
3.
4.
5.
6.
Install the application.
Upload a correct license file.
Ensure that the application is running.
Select the main country (check section 5.1).
Optional: Create a Region of Interest delimiting the detection area (check section 6).
Configure the reporting options and the camera ID (check section 5.3.1).
Important: The “Reset” button at the Main Page will reset to default all the parameters.
8
VaxALPR On Camera
User Manual 1.9.5
5. Settings
Please, read carefully this section to setup correctly VaxALPR On Camera application to your
environment conditions.
VaxALPR On Camera settings are located at the Applications->VaxALPR On Camera->Settings
area on the left menu.
Main page: Will open a new window with the available settings.
VaxALPR On camera
9
VaxALPR On Camera
User Manual 1.9.5
Main Page
At the bottom of the page there are four buttons:
-
Submit: Send the values to the camera
Dismiss: Dismiss local changes a reload the current values.
Reset: Reset the LPR settings to the default values.
Save XML: Download a XML file with the current LPR settings in the camera.
Note: The “helps” button at the Main Page will show the parameters information.
Note: The “Show advanced options” checkbox will display more options available to the user.
We do not recommend to modify this options unless told otherwise.
10
VaxALPR On Camera
User Manual 1.9.5
5.1
Country Options
Countries
Including at least 1 reference country is mandatory. The OCR is country independent, however
setting at least one reference increases performance which is a key factor to consider inside
the camera environment.
The country reference does not necessarily mean that plates from other countries are not read
(see grammar strict parameter)

Countries (1-5): In order to add a new country to the list, click and select from the menu
and press the “+” button. The country will be added to the list below. It is possible to add
up to 5 countries.
To remove a country from the list, press the “x” button.
Important: Sort the countries list appearance from more to less probability of occurrence.
For instance, if the ANPR is set in UK, set UK as first reference country. To switch the order,
drag and drop the selected country to right position.
Background mode
Establish a difference between plate font and background color

“Dark foreground, light background”: Select this option when the plate background color
is lighter than the characters (for instance, black fonts on white background)

“Light foreground, dark background”: Select this option when the plate background color
is darker than the characters (for instance, white fonts on black background)

“Both”: Select this option when both types of plates may appear.
Important: Be accurate with this option. Do not select “both” unless it really makes sense in
your scenario since the OCR performance is strongly affect by this setting
Grammar strict
Enable this option to bound results to the list of selected countries according to its plate
grammar. Only the plates matching the countries grammar will be considered as a valid result.
Disable this option to consider valid any read regardless there was a match or not among the
countries list.
Important: False positives may arise when this option is unchecked. The recommendation is to
leave this ON in free-flow mode and OFF in triggered mode
11
VaxALPR On Camera
User Manual 1.9.5
Minimum number of characters (Advanced option)
Adjust plate number of potential characters

Minimum Number of Plate Characters: Minimum number of characters needed to be
considered a valid plate.

Maximum Number of Plate Characters: Maximum number of characters to be considered
a valid plate.
Read double line plates (Advanced option)
Check this option to read plates with 2 lines.
Important: Uncheck this option if you do not consider reading squared plates
5.2
Environment Options
Resolution
Display the list of available resolutions suitable for VaxALPR On Camera. Options like “Mirror
image” and “Rotate image” do not affect the ALPR video stream, please do not use this
options in cameras used for ALPR.
Important: This resolution does not necessarily have to match the resolution set in the camera
main stream. To have an idea of what the scenario looks like it is recommended to set the
camera main stream to the same as you’re setting for the OCR. This way you can check the real
video “as is” from Axis Live Video View. The ALPR stream is captured directly from the sensor
of the camera.
Repeated plates
Minimum elapsed time to output the same plate (again)

Same Plate Delay (seconds): Time elapsed before the same plate is re-sent as a valid
result. It is recommended to set this option to 0 seconds in triggered mode.
For example, if the plate appears in the screen 10 second and the same plate delay is set in 2
seconds, the same plate will be throw up 5 times.
Minimum number of characters
Since version 1.9.5, the camera has an automatic adjust mechanism available to setup the
range of the character height in pixels.

Automatic character height adjustment: The camera will perform an automatic
adjustment. This setup is performed with the 50 first plate detected by the system and
then gradually adjusted over time. It is important that within the first 50 plates detected
12
VaxALPR On Camera
User Manual 1.9.5
we cover all the possible scenarios for the environment (double lanes, etc.). A worse
performance of the OCR can arise during the first 50 plates detection phase.
Important: This option is only available if “Grammar strict” is active.

Minimum and Maximum Character Height (12-70 pixels): If the automatic adjustment is
disabled, the user must define the minimum and maximum height in pixels of the plate
characters. To obtain a better performance of the application, it is recommended a
distance between 8 and 10 pixels from the minimum to the maximum values set. Check
section ¡Error! No se encuentra el origen de la referencia..
Important: The more you narrow this range the faster and accurate the OCR will run. Skip
setting ranges such as min 14 and max 70 or similar unless it is necessary. If plate characters
fluctuate between 22 and 28 for instance, set 20 and 30 rather than 14 and 70
Enable Whitelist and Blacklist
When these options are checked, the camera will check the plates detected against its internal
blacklist and whitelist. Clicking the button “Configure” will open a new window to setup each
list. Check section 7 for more details on how to setup the different lists inside the camera.
Slope angle (Advanced option)

Maximum Slope Angle (0-40 degrees): Maximum slope allowed for the application. A
slope over 30 degrees is not recommended
Region Of Interest (Advanced option)
Clicking the button “Configure” will open a new window to setup the Region of Interest. Check
section 6 for more details.
13
VaxALPR On Camera
User Manual 1.9.5
5.3

OCR Options
Mode:
o
Free-Flow: The ANPR works in continuous mode and does not require any trigger to
operate. All plates read are reported in real time.
o
Triggered: The application work in triggered mode using physical IO ports or Axis
virtual ports (see section 5.3.1). When the trigger event is set, the application will
perform a recognition and return the captured plate. If the system doesn’t
recognize a plate an event with “NONE” plate number is launched.
o
Axis Motion Detection: The motion detection activates the free-flow reading. The
application will recognize plates only when “Axis Motion Detector” event is active.
OCR Confidence (Advanced option)

Minimum Global Confidence (0-100): Minimum confidence needed in a plate recognition
to be a valid result. The global confidence is the average of the characters’ confidence.

Minimum Character confidence (0-100): Minimum confidence needed in a character to
be set as valid.
5.3.1
Triggered Options

Port number: Camera port number.

Is a virtual port: Check if the port number is a virtual port.
5.4


Reporting Options
Write results to SD: When checked, the camera will save a JPEG image on each
recognition to the SD card in the camera. The images are stored in the folder
“/areas/Vaxreader/<date>/” inside the SD, and the image file name is set to:
o
For each plate detected: HHMMSS-PLATE.jpg in UTC time.
o
If the plate is on the blacklist: BLACKLIST/HHMMSS-PLATE.jpg in UTC time.
o
If the plate is on the whitelist: WHITELIST/HHMMSS-PLATE.jpg in UTC time.
Write results to Network: When checked, the camera will save a JPEG image on each
recognition to the network share configured in the camera. The images are stored in the
folder “/areas/Vaxreader/<date>/” inside the network share folder, and the image file
name is set to:
o
For each plate detected: HHMMSS-PLATE.jpg in UTC time.
o
If the plate is on the blacklist: BLACKLIST/HHMMSS-PLATE.jpg in UTC time.
o
If the plate is on the whitelist: WHITELIST/HHMMSS-PLATE.jpg in UTC time.
14
VaxALPR On Camera
User Manual 1.9.5

Send VAPIX / ONVIF events: When checked, the camera will send VAPIX / ONVIF event on
each recognition. The message format is detailed in the section 10 for plates detected,
plates on the blacklist and plates on the whitelist respectively.
o

ID: Numeric ID. Each report will use this ID as source.
Send Milestone or POST events: When checked, the camera will send a HTTP POST
notification to the Host, Port and Route specified bellow. The message posted is a wellformed XML following the format specified in the section 11.3 .
o
HOST: IP or hostname of the destination.
o
Port: Destination port.
o
Camera IP or ID: Public IP of the AXIS camera. Milestone will use this field to
identify the source of the event.
o
Route: The URL where the notification will be sent. Set this field to “/” in case that
the HOST is a Milestone server.
Video Stream Settings, Overlay section
15
VaxALPR On Camera
User Manual 1.9.5

Insert Overlay: When checked VaxALPR On Camera will modify the dynamic overlay in the
Axis camera. To enable this option, it is necessary to include “#D” in the overlay settings.
o


Overlay Text: The desired overlay text. The text accepts special words that will be
replaced dynamically with the data of the current plate detected:

$date$: The date in ISO8601 format.

$plate$: The plate number.

$country$: The plate country.

$blacklist$: The description on the blacklist associated to this plate.

$whitelist$: The description on the whitelist associated to this plate.

$ifblacklist$ .... $ifblacklist$: The text between the $ifblacklist$ tags
will only be show if the plate is on the blacklist.

$ ifwhitelist$ .... $ifwhitelist$: The text between the $ifwhitelist$ tags
will only be show if the plate is on the whitelist.
o
Overlay Camera: VAPIX Camera ID.
o
Axis User: User name with privileges in the camera to setup a dynamic overlay.
o
Axis Password: Password associated to the given user.
Dorlet integration: When checked, the camera will send a notification to the AS/3
controller configured.
o
AS/3 Host: IP or hostname of the AS/3 controller.
o
AS/3 Port: Destination port.
o
AS/3 LAM: LAM ID.
o
AS/3 Vial Id: Vial ID.
Send proprietary events: When checked, the camera will send a notification to the Host
and Port specified bellow. The format of this notification is specified in the section 11.2.
o
HOST: IP or hostname of the destination.
o
Port: Destination port.
o
ID: Numeric ID. Each report will use this ID as source.
For .NET developers you can download VaxAlprRemotePlateParser.dll class library from
our web site to parse incoming raw data messages from VaxALPR On Camera and get an
easy to manage object with all results accessible to class members. The process is as
follows:
-
Get proprietary notification from VaxALPR On Camera in raw format (Annex I)
-
Send the full message data to the DLL parser and get a plate result instance. Class
members are “GetPlateNumber()”, “GetOCRImage()”, “GetCountry()” and so on…
The source code for our VaxALPR On Camera Viewer is also published at Vaxtor webpage.
16
VaxALPR On Camera
User Manual 1.9.5
6. Region of interest configuration (ROI)
To define a new region of interest, follow the next steps:
1. Click on the video image to draw the polygon. Each click will add a new node to the
polygon. The polygon will be draw in red color.
2. To restart the polygon press “Clear current ROI” button.
3. To finish the definition of the ROI press the “Save ROI” button. The ROI polygon will turn
green if set correctly.
To delete an existing ROI:
1. Press the “Delete ROI” button. The defined ROI will be erased from the video image.
Region of Interest Configuration
Important: A well-defined region of interest may shoot up the OCR performance. Use this tool
anytime you can, but beware with small regions. Try to maximize the potential recognition
area within the polygon while excluding zones where the plate won’t ever appear.
The view in the ROI matches the camera main stream resolution, not the one set from the OCR
menu. However, the selected region will be valid under the OCR’s. If you would like to visualize
exactly the same OCR view, please set both camera main stream and OCR to the same
resolution.
17
VaxALPR On Camera
User Manual 1.9.5
7. Blacklist and whitelist configuration
VaxALPR On Camera is able to operate with a blacklist and a whitelist stored on the camera.
Both lists are managed internally and uses the same user interface. To access the list
management areas, press on the button “Configure” of each list at the main configuration
page.
Whitelist Configuration
7.1
Add a new plate
To add a new plate to the list:
1. Type the plate number on the plate textbox. The description field is optional.
2. Press the “Add” button. The plate will appear on the plate list.
3. Click “Save list” to send the information to the camera.
Important: No data is sent to the camera until the button “Save list” is pressed.
7.2
Modify the description of a plate
1. Type the plate number on the plate textbox or select the plate on the list. The current
description will be automatically filled up on the description textbox.
2. Type the new description on the description textbox.
3. Click the “Edit” button. The plate with the new description will appear on the list.
4. Click “Save List” to send the information to the camera.
18
VaxALPR On Camera
User Manual 1.9.5
Whitelist plate edition
7.3
Delete a plate
1. Type the plate number on the plate textbox or select the plate on the list. Multiple
plates can be select (keep the control key pressed while clicking on the list).
2. Press the button “Delete”. If multiple plates are selected a confirmation dialog will
appear. The plates are deleted from the list.
7.4
Delete the list from the camera
To delete the list from the camera, press the button “Delete list”. A confirmation dialog will
appear.
Important: Once a list is deleted it can’t be recovered.
7.5
Export to a XML file
To export a list to a XML file, press the button “Export to XML file”. A file with the name of the
list will be downloaded. The XML file format is:
<Blacklist>
<BlacklistItem>
<plate>platenumber</plate>
<description>description for the plate</description>
<BlacklistItem>
</Blacklist>
The list can have 0 or multiple BlacklistItem. If the list is a whitelist the first node will be
<Whitelist> and the item nodes will be <WhitelistItem>.
19
VaxALPR On Camera
User Manual 1.9.5
7.6
Import from a CSV file
The camera can upload a csv file. This example will use Microsoft Excel to generate the csv file,
but other tools may work also.
1. Create an empty excel book and populate the columns. The first row MUST HAVE the
header (PLATE, DESCRIPTION, ID, etc.). Fields PLATE and DESCRIPTION are mandatory.
All the other fields will be ignored by the import process.
Whitelist example
20
VaxALPR On Camera
User Manual 1.9.5
2. Save the file as a csv file.
3. On the blacklist interface click the button “Import a file” and select the csv file.
Importing a file will not mix the current list on the camera with the imported list. The
current list on the camera will be ignored.
Export to CSV file
21
VaxALPR On Camera
User Manual 1.9.5
8. VaxALPR On Camera Viewer
You can download this free application from our website to monitor plates read by VaxALPR
On Camera. You shall activate proprietary notifications from the OCR configuration menu.
1. Go to VaxALPR On Camera configuration menu.
2. Go Notifications and select Send Proprietary Notifications
a. HOST: The computer IP where you’re running VaxALPR On Camera Viewer
b. PORT: Selected port number
c. ID: Number such as 1,2,3…
3. Run VaxALPR On Camera Viewer in your PC
4. Set the port number the same number you put in the camera PORT notification
5. Press the button “Start Listening” to capture the plates read from the camera
VaxALPR On Camera Viewer screen
Important: If no plates are reported to the viewer, please make sure that a firewall is not
blocking the connection.
22
VaxALPR On Camera
User Manual 1.9.5
9. Integration with Axis Camera Station
AXIS Camera Station is the ideal solution to meet the needs for efficient surveillance of smalland midsized installations, such as retail shops, hotels, schools and manufacturing sites – a
proven solution with more than 50,000 installations worldwide. It is designed to perfectly
match Axis’ wide range of network video products and product features to optimize system
reliability.
Web: http://www.axis.com/global/en/products/axis-camera-station
9.1
Requisites
This manual assume that the user has already installed and configured correctly:
-
VaxALPR On Camera (version 1.9.5 or upper).
AXIS Camera Station (version 5.02.015 or upper).
The AXIS camera with VaxALPR On Camera installed must be correctly configured in AXIS
Camera Station.
It is out of the scope of this section the correctly setup of both solutions, please refer to the
documentation available at http://www.vaxtor.es/vaxalpr-axis.html and
http://www.axis.com/global/en/products/axis-camera-station/support-and-documentation.
9.2
Capturing events from VaxALPR On Camera
VaxALPR On Camera is able to send VAPIX/ONVIF events when a plate is recognized. Check
section 5.4 to activate those events.
VaxALPR On Camera send 3 different events:
-
Analysis/ALPR: This event is send each time a plate is recognized by the system.
Analysis/Blacklist: This event is send each time a plate that is on the blacklist is
recognized by the system.
Analysis/Whitelist: This event is send each time a plate this is on the whitelist is
recognized by the system.
To capture any of these events in Camera Station:
1. Click on the “Configuration” Button and select “Recording & Events”.
23
VaxALPR On Camera
User Manual 1.9.5
2. Select the tab “Advanced rules” and click the button “New…”
24
VaxALPR On Camera
User Manual 1.9.5
3. Add a new Trigger. Click the button “Add…” and select “Device Event” on the list. A
new window will pop to configure the event.
4. Select the Device with the application VaxALPR On Camera installed and the desired
event (IE: Analysis / Blacklist).
5. Define the time that the event will be active (5 seconds by default) and the desired
filters. For example, it is possible to use the description filter to trigger the event only
when a vehicle is on the blacklist and the description match with the description
assigned on the camera blacklist. A user case could be to activate an I/O port that open
a secondary door when a selected group of vehicles are detected (VIP cars).
25
VaxALPR On Camera
User Manual 1.9.5
6. Define the actions to be performed. Refer to the AXIS Camera Station manual to learn
more about the possible actions. In this example we will rise an alarm.
7. Define the schedule.
8. Define a name for the rule in the details and click “Finish”.
26
VaxALPR On Camera
User Manual 1.9.5
This example will make an alarm to appear on the Alarm Camera Station section.
27
VaxALPR On Camera
User Manual 1.9.5
10. Tips and basic troubleshooting guide
You can use this guide to help you identify and resolve basic problems you may be
experiencing with the VaxALPR On Camera application.
I launch VaxALPR and stops suddenly
Make sure the license installed is valid
The software is running OK but it’s reading nothing
Can you see the plate with your eyes in the image? If the answer is NO, adjust the zoom and
focus to visualize the plate… if it’s YES, continue reading…
Assuming the countries list is correct… we’re going to set the parameters as much global as
possible and we’ll refine later…
1.
2.
3.
4.
Decrease confidence levels: 25 per character and 50 global
Increase characters’ height range to something between 14 and 60 pixels
Disable grammar strict
Remove any existent ROI
Now it’s working OK…
Then we can refine the parameters
- Check the “log” to visualize the characters’ plate height to narrow the min/max range.
[INFO] Vaxreader: Plate 0 (<pixel height> - <milliseconds>): <plate>
- Do not make the ROI very strict
- Increase confidence level: 40 per character and 70 global
- Enable grammar strict
Now it’s working OK… but missing many plates
Assuming the OCR configuration is OK, check the log to display OCR recognition time and make
sure the ROI is correctly set. Please make sure vehicles are not moving at medium-high speed
or the cameras has a very large resolution that slows down the OCR processing.
Still not working fine…
Some tips about the camera settings
- The camera resolution impacts dramatically in OCR performance. If you have set 1.2 Mpix
and get plates 40 pixels’ height, it’s recommended to set 0.6 Mpix and get 20 pixels’ height
plates.
- The maximum gain recommended (Video&Audio->Camera Settings->Exposure Settings)
should be around 9 dB
- Shutter recommendation: fixed within this range:
a. 1/250: When the vehicle will stop in front of the camera.
b. 1/500: When the vehicle speed is lower than 40 km/h.
c. 1/1000: When the vehicle speed is higher than 40 km/h.
28
VaxALPR On Camera
User Manual 1.9.5
How can I calculate the height in pixels of a plate?
Since version 1.9.5 an automatic character height adjustment method is implemented. If it is
possible we recommend it.
If it is impossible to use it, to check the height in pixels of the plate characters it is
recommended to capture a frame of the video feed and measure the height with an external
program like Microsoft Paint.
It is also possible to set the maximum and minimum height to 70 and 12 pixels respectively
and check in the log file the recognized values. This option will not work if the plate is bigger
than 70 pixels or lower than 12.
Log button
Log file
29
VaxALPR On Camera
User Manual 1.9.5
11. Developers area
VaxALPR On Camera provides a small API to interact with third parties. Contact with Vaxtor
Systems if you are interested in this area.
11.1 VaxALPR On Camera events definition
VaxALPR On Camera can communicate with third party applications using a VAPIX notification.
The camera sends 3 different events:

ALPR events: This event is send each time a plate is detected by the camera.

Blacklist events: This event is send each time a plate in the blacklist is detected by the
camera.

Whitelist events: This event is send each time a plate in the whitelist is detected by the
camera.
11.1.1 ALPR event declaration
<!—VaxALPR On Camera Event -->
<Declaration>
<Item>
<Key NameSpace="tnsaxis">topic0</Key>
<String>CameraApplicationPlatform</String>
</Item>
<Item>
<String>Analysis</String>
</Item>
<Item>
<String>ALPR</String>
</Item>
<Item>
<Key>id</Key>
<String/>
<Tag>onvif-source</Tag>
</Item>
<Item>

<Key>plate</Key>
<String/>
<Tag>onvif-data</Tag>
</Item>
<Item>

<Key>timestamp</Key>
<String/>
</Item>
<Item>
30
VaxALPR On Camera
User Manual 1.9.5

<Key>country</Key>
<String/>
</Item>
<Item>

<Key>confidence</Key>
<String/>
</Item>
<Item>

<Key>charconfidence</Key>
<String/>
</Item>
<Item>

<Key>charheight</Key>
<String/>
</Item>
<Item>

<Key>processtime</Key>
<String/>
</Item>
<Item>

<Key>left</Key>
<String/>
</Item>
<Item>
<Key>top</Key>
<String/>
</Item>
<Item>
<Key>right</Key>
<String/>
</Item>
<Item>
31
VaxALPR On Camera
User Manual 1.9.5
<Key>bottom</Key>
<String/>
</Item>
<Item>

<Key>roi</Key>
<String/>
</Item>
</Declaration>
11.1.2 Blacklist event

<Declaration>
<Item>
</Item>
<Item>
</Item>
<Item>
<String>Blacklist</String>
</Item>
<Item>
<Key>id</Key>
<String/>
</Item>
<Item>

<Key>plate</Key>
<String/>
</Item>
<Item>
<String/>
</Item>
<Item>

<Key>description</Key>
<String/>
32
VaxALPR On Camera
User Manual 1.9.5
</Item>
</Declaration>
11.1.3 Whitelist event

<Declaration>
<Item>
</Item>
<Item>
</Item>
<Item>
<String>Whitelist</String>
</Item>
<Item>
<Key>id</Key>
<String/>
</Item>
<Item>

<Key>plate</Key>
<String/>
</Item>
<Item>
<String/>
</Item>
<Item>

<Key>description</Key>
<String/>
</Item>
</Declaration>
33
VaxALPR On Camera
User Manual 1.9.5
11.2 Proprietary event format
Each time VaxALPR On Camera recognizes a new plate, the application will open a TCP/IP
communication, send the following message and close the connection.
Message format:
- 4 bytes, int32 => 0xCAFEBABE is the start message header identifier (fixed)
- 4 bytes, int32 => 0xBABE10 result message (fixed)
- 4 bytes, int32 => VaxALPR instance ID, matches the tag Instance-ID from VaxALPR configuration file
- 8 bytes, int64 => Time Stamp, current date in milliseconds
- 4 bytes, int32 => NC1: number of ASCII characters of the plate number
- NC1 bytes, byte => ASCII bytes array
- 4 bytes, int32 => NC2: number of ASCII characters of the plate origin
- NC2 bytes, byte => ASCII bytes array
- 4 bytes, int32 => ROI ID containing the license plate (1…n). 0 value means plate out of any ROI (Unused)
- 8 bytes, double => Global confidence of plate recognition: [0...100]
- 8 bytes, double => Characters height, in pixels
- NC1 bytes, float => per character recognition confidence [0…100]
- 8 bytes, double => OCR processing time, in milliseconds
- 4 bytes, int32 => 'x0' coordinate of the plate left-top corner, in pixels
- 4 bytes, int32 => 'y0' coordinate of the plate left-top corner, in pixels
- 4 bytes, int32 => 'x1' coordinate of the plate right-bottom corner, in pixels
- 4 bytes, int32 => 'y1' coordinate of the plate right-bottom corner, in pixels
- 8 bytes, int64 => OCR image timestamp, in milliseconds
- 4 bytes, int32 => SF: size of the OCR image, in bytes
- SF bytes, byte => OCR image data in JPEG format
- 4 bytes, int32 => R1: size of image reserved data, in bytes
- R1 bytes, byte => reserved data, R1 bytes
- 8 bytes, int64 => Environment image timestamp, in milliseconds (Unused)
- 4 bytes, int32 => SF: size of the environment image, in bytes (Unused)
- SF bytes, byte => Environment image data in JPEG format (Unused)
- 4 bytes, int32 => R2: size of image reserved data, in bytes (Unused)
- R1 bytes, byte => reserved data, R2 bytes (Unused)
- 4 bytes, int32 => vehicle direction, if available: 0=>unknown, 1=>closer, 2=>farther (Unused)
- 4 bytes, int32 => ALPR multi-plate rate (Unused)
- 4 bytes, int32 => 1: plate reported under SYNCHRO_SIGNALED mode, 0: SYNCHRO_FREE_FLOW mode
- 4 bytes, int32 => N: Size of reserved space
- N bytes, byte => reserved space, user information. Put here custom information (*)
- 4 bytes, int32 => 0x42F87D89 is the end message header identifier (fixed)
(*) On the reserved space VaxALPR On Camera will insert the whitelist, blacklist and wide
character fields in different packets:

Whitelist:
- 4 bytes, int32 => N: Packet identifier. Value 3.
- 4 bytes, int32 => N: Format identifier. Value 1.
- 4 bytes, int32 => NC: number of ASCII characters of the description.
- NC bytes, byte => ASCII bytes array

Blacklist:
- 4 bytes, int32 => NC: number of ASCII characters of the description.
34
VaxALPR On Camera
User Manual 1.9.5
- NC bytes, byte => ASCII bytes array

Wide Character packet:
- 4 bytes, int32 => NC: number of bytes for the Unicode or UTF32 string.
- NC bytes, byte => Bytes array.
35
VaxALPR On Camera
User Manual 1.9.5
11.3 HTTP POST Format
Each time VaxALPR On Camera recognizes a new plate, the application will send a POST
notification with a well-formed XML. The XML follow the schema defined in the
AnalyticsEvent.xsd available at www.vaxtor.com website.
If the plate is on the blacklist and/or in the whitelist another POST will be sent. The Type field
will be “Blacklist License Plate Recognition” or “Whitelist License Plate Recognition”
respectively.
The following XML is an example of a response for plate number M8016LS. The bounding box
is referred to the snapshot in the message.
<?xml version="1.0" encoding="utf-8"?>
<AnalyticsEvent xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:milestone-systems">
<EventHeader>
<ID>00000000-0000-0000-0000-000000000000</ID>
<Timestamp>2016-05-23T08:39:36.135998Z</Timestamp>
<Type>License Plate Recognition</Type>
<Message>VaxALPR On Camera Event</Message>
<CustomTag>M8016LS</CustomTag>
<Source>
<Name>192.168.0.100</Name>
</Source>
</EventHeader>
<Description>M8016LS</Description>
<ObjectList>
<Object>
<Name>Plate</Name>
<Confidence>0.972857</Confidence>
<Value>M8016LS</Value>
<AlarmTrigger>true</AlarmTrigger>
<Size>46</Size>
<BoundingBox>
<Top>0.42</Top>
<Left>0.23</Left>
<Bottom>0.54</Bottom>
<Right>0.55</Right>
</BoundingBox>
</Object>
</ObjectList>
<SnapshotList>
<Snapshot>
<TimeOffset>0</TimeOffset>
<Width>1280</Width>
<Height>960</Height>
<SizeInBytes>193656</SizeInBytes>
<Image>BASE64ENCODEDJPEG</Image>
</Snapshot>
</SnapshotList>
<Vendor>
<Name>Vaxtor Systems</Name>
</Vendor>
</AnalyticsEvent>
36
VaxALPR On Camera
User Manual 1.9.5
12. Changelog
Version 1.9.5:

Improvements on accuracy and performance.

New: Whitelist management.

New: Blacklist management.

New: CameraApplicationPlatform/Analysis/Whitelist and Blacklist Axis events.

New: Dynamic Overlay management.

New: Write ALPR results to network share.

New: AS/3 TCP controller integration (Dorlet).

UI improvements.

Minor bug fixes.
37

License plate recognition technology embedded in AXIS camera

Transcripción

Documentos relacionados

License plate recognition technology embedded in

high performance 5-megapixel color camera for your

GAS DETECTION

Operation Manual

User Manual Model: FI8909W Indoor Wireless IP Camera NIGHT

2 - AgfaPhoto

User Manual

Something about the name of this sportive hinted to

User Manual Outdoor HD IP Camera