Skew detection and correction in images containing text
Project description
Deskew
Note: Skew is measured in degrees. Deskewing is a process whereby skew is removed by rotating an image by the same amount as its skew but in the opposite direction. This results in a horizontally and vertically aligned image where the text runs across the page rather than at an angle.
The return angle is between -45 and 45 degrees to don't arbitrary change the image orientation.
By using the library you can set the argument angle_pm_90 to True to have an angle between -90 and 90 degrees.
Skew detection and correction in images containing text
| Image with skew | Image after deskew |
|---|---|
 |
 |
Installation
You can install deskew directly from pypi directly using the following comment
python3 -m pip install deskew
Or to upgrade to newer version
python3 -m pip install -U deskew
Cli usage
Get the skew angle:
deskew input.png
Deskew an image:
deskew --output output.png input.png
Lib usage
With scikit-image:
import numpy as np
from skimage import io
from skimage.color import rgb2gray
from skimage.transform import rotate
from deskew import determine_skew
image = io.imread('input.png')
grayscale = rgb2gray(image)
angle = determine_skew(grayscale)
rotated = rotate(image, angle, resize=True) * 255
io.imsave('output.png', rotated.astype(np.uint8))
With OpenCV:
import math
from typing import Tuple, Union
import cv2
import numpy as np
from deskew import determine_skew
def rotate(
image: np.ndarray, angle: float, background: Union[int, Tuple[int, int, int]]
) -> np.ndarray:
old_width, old_height = image.shape[:2]
angle_radian = math.radians(angle)
width = abs(np.sin(angle_radian) * old_height) + abs(np.cos(angle_radian) * old_width)
height = abs(np.sin(angle_radian) * old_width) + abs(np.cos(angle_radian) * old_height)
image_center = tuple(np.array(image.shape[1::-1]) / 2)
rot_mat = cv2.getRotationMatrix2D(image_center, angle, 1.0)
rot_mat[1, 2] += (width - old_width) / 2
rot_mat[0, 2] += (height - old_height) / 2
return cv2.warpAffine(image, rot_mat, (int(round(height)), int(round(width))), borderValue=background)
image = cv2.imread('input.png')
grayscale = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
angle = determine_skew(grayscale)
rotated = rotate(image, angle, (0, 0, 0))
cv2.imwrite('output.png', rotated)
Debug images
If you get wrong skew angle you can generate debug images, that can help you to tune the skewing detection.
If you install deskew with pip install deskew[debug_images] you can get some debug images used for
the skew detection with the function determine_skew_debug_images.
To start the investigation you should first increase the num_peaks (default 20) and use
the determine_skew_debug_images function.
Then you can try to tune the following arguments num_peaks, angle_pm_90, min_angle, max_angle,
min_deviation and eventually sigma.
Inspired by Alyn: https://github.com/kakul/Alyn
Contributing
Install the pre-commit hooks:
pip install pre-commit
pre-commit install --allow-missing-config
Release history Release notifications | RSS feed
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
File details
Details for the file deskew-1.5.1.tar.gz.
File metadata
- Download URL: deskew-1.5.1.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b27d910da9ec34fa9abf867e3aed19dda87ab12529fc51124d38b7299ffaa387 |
|
| MD5 | 2b1b139555a930929e1cf60b32fa4a62 |
|
| BLAKE2b-256 | 2fdddc20f529fc1246e52e851a79ae718951134dda366c070e48c08c03654c3c |
File details
Details for the file deskew-1.5.1-py3-none-any.whl.
File metadata
- Download URL: deskew-1.5.1-py3-none-any.whl
- Upload date:
- Size: 7.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4759427758c6a754077eed306c5ef22ebc9644d557748763f968cfd242ead18f |
|
| MD5 | 903430a5f9bef400e2684d48de2e0c21 |
|
| BLAKE2b-256 | 4bb70dd282f6e83759939cd0ea78920cc67c7d57503f9ba2f51deaf05ecb1f20 |
