License plate recognition technology embedded in AXIS camera
Transcripción
License plate recognition technology embedded in AXIS camera
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 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 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 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 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: 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 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. 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 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 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 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 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 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. 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 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 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 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. 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 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 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 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 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 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. 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 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. 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 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 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 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. 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 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. 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 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. 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 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. 3. Click “Save list” to send the information to the camera. 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>. 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 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 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 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. 4. Click “Save list” to send the information to the camera. Export to CSV file 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 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. 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 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”. 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 23 VaxALPR On Camera User Manual 1.9.5 2. Select the tab “Advanced rules” and click the button “New…” 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 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). 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 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”. 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 26 VaxALPR On Camera User Manual 1.9.5 This example will make an alarm to appear on the Alarm Camera Station section. 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 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. 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 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 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 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> <Key NameSpace="tnsaxis">topic1</Key> <String>Analysis</String> </Item> <Item> <Key NameSpace="tnsaxis">topic2</Key> <String>ALPR</String> </Item> <Item> <Key>id</Key> <String/> <Tag>onvif-source</Tag> </Item> <Item> <!-- The plate string --> <Key>plate</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Video timestamp --> <Key>timestamp</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> 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 30 VaxALPR On Camera User Manual 1.9.5 <!-- Country --> <Key>country</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Global confidence --> <Key>confidence</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Characters confidence --> <Key>charconfidence</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Average Char Height --> <Key>charheight</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Process Time --> <Key>processtime</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Plate location --> <Key>left</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Plate location --> <Key>top</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Plate location --> <Key>right</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> 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 31 VaxALPR On Camera User Manual 1.9.5 <!-- Plate location --> <Key>bottom</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- ROI ID (unused) --> <Key>roi</Key> <String/> <Tag>onvif-data</Tag> </Item> </Declaration> 11.1.2 Blacklist event <!-- Vaxtor ALPR Event --> <Declaration> <Item> <Key NameSpace="tnsaxis">topic0</Key> <String>CameraApplicationPlatform</String> </Item> <Item> <Key NameSpace="tnsaxis">topic1</Key> <String>Analysis</String> </Item> <Item> <Key NameSpace="tnsaxis">topic2</Key> <String>Blacklist</String> </Item> <Item> <Key>id</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- The plate readed --> <Key>plate</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Video timestamp --> <Key>timestamp</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Description --> <Key>description</Key> <String/> 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 32 VaxALPR On Camera User Manual 1.9.5 <Tag>onvif-data</Tag> </Item> </Declaration> 11.1.3 Whitelist event <!-- Vaxtor ALPR Event --> <Declaration> <Item> <Key NameSpace="tnsaxis">topic0</Key> <String>CameraApplicationPlatform</String> </Item> <Item> <Key NameSpace="tnsaxis">topic1</Key> <String>Analysis</String> </Item> <Item> <Key NameSpace="tnsaxis">topic2</Key> <String>Whitelist</String> </Item> <Item> <Key>id</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- The plate readed --> <Key>plate</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Video timestamp --> <Key>timestamp</Key> <String/> <Tag>onvif-data</Tag> </Item> <Item> <!-- Description --> <Key>description</Key> <String/> <Tag>onvif-data</Tag> </Item> </Declaration> 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 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 => N: Packet identifier. Value 2. - 4 bytes, int32 => N: Format identifier. Value 1. - 4 bytes, int32 => NC: number of ASCII characters of the description. 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 34 VaxALPR On Camera User Manual 1.9.5 - NC bytes, byte => ASCII bytes array Wide Character packet: - 4 bytes, int32 => N: Packet identifier. Value 1. - 4 bytes, int32 => N: Format identifier. Value 1. - 4 bytes, int32 => NC: number of bytes for the Unicode or UTF32 string. - NC bytes, byte => Bytes array. 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 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> 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 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. 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 37
Documentos relacionados
License plate recognition technology embedded in
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 th...
Más detalles