Platefetcher

Scan the number plate and get all the details of the vehicle!

Usage

🛠️ Building the image

$ sudo docker build --platform linux/arm64/v8 -t <IMAGE-NAME> .

Pulling the image

$ sudo podman/docker pull --platform linux/arm64/v8 docker.io/yashindane/demoplate:12

▶️ Running the container

Using podman

$ sudo podman run --network=host --platform linux/arm64/v8 -dit --device /dev/video0 --name <NAME> \
  docker.io/yashindane/demoplate:12 --aak="<AWS_ACCESS_KEY>" --ask="<AWS_SECRET_KEY>" \
  --region="<DEFAULT_REGION>" --bucketname="<BUCKET_NAME>" --user="<REG_CHECK_USER>"

Using docker

$ sudo docker run --platform linux/arm64/v8 -dit -p <PORT>:2400 --device /dev/video0 --name <NAME> \
  docker.io/yashindane/demoplate:12 --aak="<AWS_ACCESS_KEY>" --ask="<AWS_SECRET_KEY>" \
  --region="<DEFAULT_REGION>" --bucketname="<BUCKET_NAME>" --user="<REG_CHECK_USER>"

Optional arguments

Argument	Description
--dbhost	Host endpoint of DB instance (String)
--dbport	Port at which DB service running (String)
--dbuser	DB username (String)
--dbpass	DB password min 8 characters (String)

Access

Tool	Path
podman	http://IP:2400/out
docker	http://IP:PORT/out

Prerequisites

1. Installing docker

$ sudo curl -fsSL https://get.docker.com -o docker-install.sh
$ sh docker-install.sh
$ sudo usermod -aG docker pi
$ sudo reboot

2. (optional) Installing podman

$ sudo apt-get -y install podman

3. (optional) Installing terraform

$ sudo wget https://releases.hashicorp.com/terraform/1.3.7/terraform_1.3.7_linux_arm64.zip
$ sudo unzip <ZIPFILE>
$ sudo mv terraform /usr/bin/

4. Create a publically accessible bucket with the IAM user in AWS. The user must have PowerUser and AdminUser access.

Configure this bucket policy-

{
  "Id": "Policy1664186300628",
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1664186298804",
      "Action": "s3:*",
      "Effect": "Allow",
      "Resource": "arn:aws:s3:::<BUCKET-NAME>/*",
      "Principal": "*"
    }
  ]
}

5. Create a account on http://www.regcheck.org.uk and pass that username with --user=.

6. (optional) Creating a mysql DB instance for all plate details to store in.

7. (optional) Creating the DB and S3 bucket using terraform

(optional) Navigate to infra-provisioning directory and run below to create DB instance and S3 bucket -

$ sudo terraform init
$ sudo terraform validate
$ sudo terraform plan
$ sudo terraform apply -var="access_key=<AWS_ACCESS_KEY>" -var="secret_key=<AWS_SECRET_KEY>" -var="bucket_name=<S3_BUCKET_NAME>" \
  -var="identifier=<DB_IDENTIFIER>" -var="db_username=<DB_USERNAME>" -var="db_pass=<DB_PASSWORD>" -auto-approve

Working

1. Using image proccesing the region of interest, ie the plate is extracted.
2. The detected plate image is uploaded to Amazon S3.
3. AWS textract uses that image to extract the numbers.
4. Raspberry Pi receives the extracted numbers.
5. Using https://www.regcheck.org.uk API the Pi gets the vehical details using the plate number.
6. The results are printed on the Phone.

Reference

[1] Ravi Kiran Varma Pa*, Srikanth Gantaa, Hari Krishna Bb, Praveen SVSRKc "A Novel Method for Indian Vehicle Registration Number Plate Detection and Recognition using Image Processing Techniques", International Conference on Computational Intelligence and Data Science (ICCIDS 2019)