Document Image Skew Estimation
Table of Contents
Table of contents generated with markdown-toc
Installation
pip
pip install jdeskew
conda
conda create --name jdeskew -c conda-forge jdeskew
How-to-use
using 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
# build
DOCKER_BUILDKIT=1 docker build -t jdeskew .
# run
docker run -p 8000:80 jdeskew
# test
curl -v -F file=@sample.png localhost:8000/predict
using cog
https://github.com/replicate/cog
cog build --debug
cog predict -i input=@skew.png
# Output:
# Running prediction...
# {
# "angle": -0.12520868113522532
# }
Download Paper
Link1: https://ieeexplore.ieee.org/document/9897910
Link3: https://huggingface.co/papers/2603.05942
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 Hugging Face: https://huggingface.co/datasets/phamquiluan/DISE-2021
Or from Zenodo: https://zenodo.org/records/12570649
Reproducibility and Evaluation Code
Check the 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.
@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}
}
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jdeskew-0.4.0.tar.gz.
File metadata
- Download URL: jdeskew-0.4.0.tar.gz
- Upload date:
- Size: 845.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
22b442f72cabee696df36e2d1e0768593b47322fc026fcf8bfec8abc5dc59381
|
|
| MD5 |
f50a92b91c0ee04668b34cc7f5024786
|
|
| BLAKE2b-256 |
9a302981d1312e8af6d45b8a8a216a4f9b972d5095cff31a4211a91581e9b33a
|
File details
Details for the file jdeskew-0.4.0-py3-none-any.whl.
File metadata
- Download URL: jdeskew-0.4.0-py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e72964eba698567a81820ff0eea2d43e561af01665a6aeef3f8c00757effbfc0
|
|
| MD5 |
7df67f695b61df8b1b89cce76e7daaf7
|
|
| BLAKE2b-256 |
7413856dbe72e6ce792592a325d665025b5670e15bdfc7d87326c6897332320c
|
