Paddle-SVHN

Classical OCR DCNN reproduction based on PaddlePaddle framework.

This project reproduces Multi-digit Number Recognition from Street View Imagery using Deep Convolutional Neural Networks based on the paddlepaddle framework and participates in the Baidu paper reproduction competition. The AIStudio link is provided as follow:

link

Results_Compared

SVHN Dataset

Introduction

The main idea of this exercise is to study the evolvement of the state of the art and main work along topic of visual attention model. There are two datasets that are studied: augmented MNIST and SVHN. The former dataset focused on canonical problem  —  handwritten digits recognition, but with cluttering and translation, the latter focus on real world problem  —  street view house number (SVHN) transcription. In this exercise, the following papers are studied in the way of developing a good intuition to choose a proper model to tackle each of the above challenges.

For more detail, please refer to this blog

Recommended environment

Python 3.6+
paddlepaddle-gpu 2.0.2
nccl 2.0+
editdistance
visdom
h5py
protobuf
lmdb

Install

Install env

Install paddle following the official tutorial.

pip install visdom
pip install h5py
pip install protobuf
pip install lmdb

Dataset

1. Download SVHN Dataset format 1

2. Extract to data folder, now your folder structure should be like below:

   SVHNClassifier
       - data
           - extra
               - 1.png 
               - 2.png
               - ...
               - digitStruct.mat
           - test
               - 1.png 
               - 2.png
               - ...
               - digitStruct.mat
           - train
               - 1.png 
               - 2.png
               - ...
               - digitStruct.mat
   

Usage

1. (Optional) Take a glance at original images with bounding boxes

   Open `draw_bbox.ipynb` in Jupyter
   

2. Convert to LMDB format

   $ python convert_to_lmdb.py --data_dir ./data
   

3. (Optional) Test for reading LMDBs

   Open `read_lmdb_sample.ipynb` in Jupyter
   

4. Train

   $ python train.py --data_dir ./data --logdir ./logs
   

5. Retrain if you need

   $ python train.py --data_dir ./data --logdir ./logs_retrain --restore_checkpoint ./logs/model-100.pth
   

6. Evaluate

   $ python eval.py --data_dir ./data ./logs/model-100.pth
   

7. Visualize

   $ python -m visdom.server
   $ python visualize.py --logdir ./logs
   

8. Infer

   $ python infer.py --checkpoint=./logs/model-100.pth ./images/test1.png
   

9. Clean

   $ rm -rf ./logs
   or
   $ rm -rf ./logs_retrain