Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yashindane/platefetcher
Scan the number plate and get all the details of the vehicle! 🚘
https://github.com/yashindane/platefetcher
arm64v8 automation aws docker flask opencv podman raspberry-pi
Last synced: about 1 month ago
JSON representation
Scan the number plate and get all the details of the vehicle! 🚘
- Host: GitHub
- URL: https://github.com/yashindane/platefetcher
- Owner: YashIndane
- License: mit
- Created: 2022-09-24T12:19:31.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-25T11:27:02.000Z (10 months ago)
- Last Synced: 2024-02-25T11:41:32.383Z (10 months ago)
- Topics: arm64v8, automation, aws, docker, flask, opencv, podman, raspberry-pi
- Language: Python
- Homepage: https://github.com/YashIndane/platefetcher
- Size: 1.52 MB
- Stars: 29
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
![plateff](https://user-images.githubusercontent.com/53041219/196192426-ad2033d6-798e-4f6e-9e08-2f1d2d7ad0d7.png)
![](https://img.shields.io/badge/raspberrypi-4B-red?logo=raspberrypi&logoColor=red)
![](https://img.shields.io/badge/python-3-red?logo=python&logoColor=blue)
![](https://img.shields.io/badge/opencv-red?logo=opencv&logoColor=purple)
![](https://img.shields.io/badge/flask-red?logo=flask&logoColor=yellow)
![](https://img.shields.io/badge/aws-red?logo=amazon&logoColor=green)
![](https://img.shields.io/badge/docker-red?logo=docker&logoColor=black)
![](https://img.shields.io/badge/podman-blue?logo=podman&logoColor=purple)
![](https://img.shields.io/badge/License-MIT-green)
![](https://img.shields.io/badge/arm64-v8-yellow?logo=arm)
![](https://img.shields.io/badge/powered%20by-RPI%20OS-pink)
[![Docker Build/Publish Image](https://github.com/YashIndane/platefetcher/actions/workflows/platefetcher_arm64v8_image_builder.yml/badge.svg)](https://github.com/YashIndane/platefetcher/actions/workflows/platefetcher_arm64v8_image_builder.yml)
## Platefetcher
Scan the number plate and get all the details of the vehicle!
![platefetcher-gif](https://user-images.githubusercontent.com/53041219/207283343-5f3e9cdc-61d8-41bd-89c0-9b540d6b7570.gif) ![ras1](https://user-images.githubusercontent.com/53041219/207283447-a2d95a6e-ca48-423f-8394-ed59ca94160f.png)
## Usage
### 🛠️ Building the image
```
$ sudo docker build --platform linux/arm64/v8 -t .
```### 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 \
docker.io/yashindane/demoplate:12 --aak="" --ask="" \
--region="" --bucketname="" --user=""
```#### Using docker
```
$ sudo docker run --platform linux/arm64/v8 -dit -p :2400 --device /dev/video0 --name \
docker.io/yashindane/demoplate:12 --aak="" --ask="" \
--region="" --bucketname="" --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
$ 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:::/*",
"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=" -var="secret_key=" -var="bucket_name=" \
-var="identifier=" -var="db_username=" -var="db_pass=" -auto-approve
```## Working
![dia](https://user-images.githubusercontent.com/53041219/196134284-fbabf6fb-1793-47c2-a190-ab565cff2233.png)
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)