Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/phamquiluan/jdeskew
ICIP 2022: Adaptive Radial Projection on Fourier Magnitude Spectrum for Document Image Skew Estimation
https://github.com/phamquiluan/jdeskew
deskew document-image-skew-correction skew-correction text-skew-estimation
Last synced: about 2 months ago
JSON representation
ICIP 2022: Adaptive Radial Projection on Fourier Magnitude Spectrum for Document Image Skew Estimation
- Host: GitHub
- URL: https://github.com/phamquiluan/jdeskew
- Owner: phamquiluan
- License: mit
- Created: 2021-10-21T06:17:56.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T15:41:55.000Z (5 months ago)
- Last Synced: 2024-04-23T16:57:30.331Z (5 months ago)
- Topics: deskew, document-image-skew-correction, skew-correction, text-skew-estimation
- Language: Jupyter Notebook
- Homepage: https://ieeexplore.ieee.org/document/9897910
- Size: 460 KB
- Stars: 104
- Watchers: 3
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Document Image Skew Estimation
[](https://pypi.org/project/jdeskew)
[](https://dl.circleci.com/status-badge/redirect/gh/phamquiluan/jdeskew/tree/master)
[](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Coverage)
[](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Grade)
[](https://pepy.tech/project/jdeskew)
[](https://paperswithcode.com/sota/document-image-skew-estimation-on-dise-2021?p=adaptive-radial-projection-on-fourier)
**Table of Contents**
- [Document Image Skew Estimation](#document-image-skew-estimation)
- [Installation](#installation)
- [pip](#pip)
- [How-to-use](#how-to-use)
- [using python](#using-python)
- [Docker](#docker)
- [using cog](#using-cog)
- [Download Paper](#download-paper)
- [Performance Comparison on DISE 2021](#performance-comparison-on-dise-2021)
- [DISE 2021 Dataset](#dise-2021-dataset)
- [Reproducibility and Evaluation Code](#reproducibility-and-evaluation-code)
- [Citation](#citation)
Table of contents generated with markdown-toc
## Installation
### pip
```bash
pip install jdeskew
```
## How-to-use
### using python
```python
from jdeskew.estimator import get_angle
angle = get_angle(image)
from jdeskew.utility import rotate
output_image = rotate(image, angle)
```
### Docker
https://hub.docker.com/r/phamquiluan/jdeskew/tags
```bash
# build
DOCKER_BUILDKIT=1 docker build -t jdeskew .
# run
docker run -p 8000:80 jdeskew
# test
curl -v -F [email protected] localhost:8000/predict
```
### using cog
https://github.com/replicate/cog
```bash
cog build --debug
cog predict -i [email protected]
# Output:
# Running prediction...
# {
# "angle": -0.12520868113522532
# }
```
## Download Paper
Link1: https://ieeexplore.ieee.org/document/9897910
Link2: https://www.researchgate.net/publication/364320913_ADAPTIVE_RADIAL_PROJECTION_ON_FOURIER_MAGNITUDE_SPECTRUM_FOR_DOCUMENT_IMAGE_SKEW_ESTIMATION
## Performance Comparison on DISE 2021
CE: Correct Estimation rate
WE: Worst Error
| | AED | TOP80 | CE | WE |
| :------------------: | :------: | :------: | :------: | :------: |
| FredsDeskew | 10.82 | 0.09 | 0.54 | 109 |
| PypiDeskew | 16.59 | 0.24 | 0.2 | 141 |
| Koo, Hyung Il et al. | 0.22 | 0.09 | 0.48 | 9.43 |
| CMC-MSU | 0.27 | 0.11 | 0.43 | 23.2 |
| LRDE-EPITA-a | 0.14 | 0.06 | 0.66 | 10.61 |
| | | | | |
| Our (1024) | 0.11 | 0.07 | 0.67 | **1.13** |
| Our (1500) | 0.09 | 0.05 | 0.78 | **1.13** |
| Our (2048) | 0.08 | **0.04** | 0.84 | **1.13** |
| Our (3072) | **0.07** | **0.04** | **0.86** | **1.13** |
| Our (4096) | 0.08 | **0.04** | 0.83 | 1.18 |
## DISE 2021 Dataset
This datasets are built upon three other datasets: DISEC 2013, RVL-CDIP, RDCL 2017. So I urge you to respect their LICENSE.
| Dataset Name | URL |
| --------------------- | ---------------------------------------------------------------------------------- |
| DISE 2021 (45 degree) | https://drive.google.com/file/d/1a-a6aOqdsghjeHGLnCLsDs7NoJIus-Pw/view?usp=sharing |
| DISE 2021 (15 degree) | https://drive.google.com/file/d/1BLiuu-j28dbuPFi4n3C0KuV6vXGmB0qS/view?usp=sharing |
Can also download from Zenodo: https://zenodo.org/records/12570649
## Reproducibility and Evaluation Code
Check the [reproduce.ipynb](reproduce.ipynb) file
## Citation
L. Pham, H. Hoang, X.T. Mai, T. A. Tran, "Adaptive Radial Projection on Fourier Magnitude Spectrum for Document Image Skew Estimation", ICIP, 2022.
```latex
@inproceedings{pham2021dise,
title={Adaptive Radial Projection on Fourier Magnitude Spectrum for Document Image Skew Estimation},
author={Luan Pham, Hao Hoang, Toan Mai, and Tuan Anh Tran},
booktitle={2022 29th International Conference on Image Processing (ICIP)},
year={2022},
organization={IEEE}
}
```
## Star History
[](https://star-history.com/#phamquiluan/jdeskew&Date)