-
Notifications
You must be signed in to change notification settings - Fork 606
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
95fbc7d
commit 8fb2b24
Showing
1 changed file
with
44 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,44 @@ | ||
# alpr-unconstrained | ||
Automatic License Plate Recognition in Unscontrained Scenarios (paper implementation) | ||
# ALPR in Unscontrained Scenarios | ||
|
||
## Introduction | ||
|
||
This repository contains the author's implementation of ECCV 2018 paper "Automatic License Plate Recognition in Unconstrained Scenarios". | ||
|
||
## Requirements | ||
|
||
In order to easily run the code, you must have installed the Keras framework with TensorFlow backend. The Darknet framework is self-contained in the "darknet" folder and must be compiled before running the tests. To build Darknet just type "make" in "darknet" folder: | ||
|
||
```shellscript | ||
$ cd darknet && make | ||
``` | ||
|
||
The current version was tested in an Ubuntu 16.04 machine, with Keras 2.0.6 and TensorFlow 1.5.0. | ||
|
||
## Download Models | ||
|
||
After building the Darknet framework, you must execute the "get-networks.sh" script. This will download all the trained models: | ||
|
||
```shellscript | ||
$ bash get-networks.sh | ||
``` | ||
|
||
## Running a simple test | ||
|
||
Use the script "run.sh" to run our ALPR approach. It requires 3 arguments: | ||
* __Input directory:__ should contain at least 1 image in JPG or PNG format; | ||
* __Output directory:__ during the recognition process, many temporary files will be generated inside this directory and erased in the end. The remaining files will be related to the automatic annotated image; | ||
* __CSV file:__ specify an output CSV file. | ||
|
||
```shellscript | ||
$ bash run.sh samples/ /tmp/output /tmp/output/results.csv | ||
``` | ||
|
||
## A word on GPU and CPU | ||
|
||
We know that not everyone has an NVIDIA card available, and sometimes it is cumbersome to properly configure CUDA. Thus, we opted to set the Darknet makefile to use CPU as default instead of GPU to favor an easy execution for most people instead of a fast performance. Therefore, the vehicle detection and OCR will be pretty slow. If you want to accelerate them, please edit the Darknet makefile variables to use GPU. | ||
|
||
## Further information | ||
|
||
* Paper webpage: http:https://www.inf.ufrgs.br/~smsilva/alpr-unconstrained/ | ||
* Dataset annotations used for training: http:https://www.inf.ufrgs.br/~crjung/alpr-datasets | ||
|