jdeskew 0.2.3__tar.gz → 0.4.0__tar.gz

jdeskew-0.4.0/.codacy.yaml

@@ -0,0 +1,3 @@
+---
+exclude_paths:
+  - "tests/**"

{jdeskew-0.2.3 → jdeskew-0.4.0}/.github/workflows/python-package.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v3

{jdeskew-0.2.3 → jdeskew-0.4.0}/Dockerfile

@@ -1,6 +1,7 @@
 FROM ubuntu:20.04
 ARG DEBIAN_FRONTEND=noninteractive
 
+# hadolint ignore=DL3008
 RUN apt-get update && apt-get install --no-install-recommends -y python3.8 python3.8-dev python3-pip ffmpeg\
   && apt-get clean \
   && rm -rf /var/lib/apt/lists/*
@@ -11,6 +12,7 @@ RUN pip install pip==22.0.3
 WORKDIR /app
 COPY . /app/
 
+# hadolint ignore=DL3013
 RUN pip install .[dev]
 EXPOSE 80
 ENTRYPOINT ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]

{jdeskew-0.2.3 → jdeskew-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: jdeskew
-Version: 0.2.3
+Version: 0.4.0
 Summary: Document Image Skew Estimation using Adaptive Radial Projection
 Author-email: Luan Pham <phamquiluan@gmail.com>
 License: MIT License
@@ -25,6 +25,19 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy
@@ -38,6 +51,7 @@ Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: fastapi; extra == "dev"
 Requires-Dist: uvicorn[standard]; extra == "dev"
 Requires-Dist: python-multipart; extra == "dev"
+Dynamic: license-file
 
 # Document Image Skew Estimation
 
@@ -46,11 +60,9 @@ Requires-Dist: python-multipart; extra == "dev"
 [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Coverage)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Grade)
 [![Downloads](https://static.pepy.tech/personalized-badge/jdeskew?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads)](https://pepy.tech/project/jdeskew)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/dependency-review.yml/badge.svg)
 ![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-package.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/docker-build-and-push.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-publish.yml/badge.svg)
-[![PWC](https://img.shields.io/endpoint.svg?url=https://paperswithcode.com/badge/adaptive-radial-projection-on-fourier/document-image-skew-estimation-on-dise-2021)](https://paperswithcode.com/sota/document-image-skew-estimation-on-dise-2021?p=adaptive-radial-projection-on-fourier)
+[![HF Paper](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Paper-yellow)](https://huggingface.co/papers/2603.05942)
+[![HF Dataset](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Dataset-blue)](https://huggingface.co/datasets/phamquiluan/DISE-2021)
 
 
 ![Cover Image](https://user-images.githubusercontent.com/24642166/165683091-4091bb3c-6625-4180-93b6-86deec9a0750.gif)
@@ -81,6 +93,12 @@ Requires-Dist: python-multipart; extra == "dev"
 pip install jdeskew
 ```
 
+### conda
+
+```bash
+conda create --name jdeskew -c conda-forge jdeskew
+```
+
 ## How-to-use
 
 ### using python
@@ -131,6 +149,8 @@ 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
 
+Link3: https://huggingface.co/papers/2603.05942
+
 
 ## Performance Comparison on DISE 2021
 
@@ -161,7 +181,9 @@ This datasets are built upon three other datasets: DISEC 2013, RVL-CDIP, RDCL 20
 | 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
+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
 
@@ -180,7 +202,3 @@ L. Pham, H. Hoang, X.T. Mai, T. A. Tran, "Adaptive Radial Projection on Fourier
   organization={IEEE}
 }
 ```
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=phamquiluan/jdeskew&type=Date)](https://star-history.com/#phamquiluan/jdeskew&Date)

{jdeskew-0.2.3 → jdeskew-0.4.0}/README.md

@@ -5,11 +5,9 @@
 [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Coverage)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Grade)
 [![Downloads](https://static.pepy.tech/personalized-badge/jdeskew?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads)](https://pepy.tech/project/jdeskew)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/dependency-review.yml/badge.svg)
 ![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-package.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/docker-build-and-push.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-publish.yml/badge.svg)
-[![PWC](https://img.shields.io/endpoint.svg?url=https://paperswithcode.com/badge/adaptive-radial-projection-on-fourier/document-image-skew-estimation-on-dise-2021)](https://paperswithcode.com/sota/document-image-skew-estimation-on-dise-2021?p=adaptive-radial-projection-on-fourier)
+[![HF Paper](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Paper-yellow)](https://huggingface.co/papers/2603.05942)
+[![HF Dataset](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Dataset-blue)](https://huggingface.co/datasets/phamquiluan/DISE-2021)
 
 
 ![Cover Image](https://user-images.githubusercontent.com/24642166/165683091-4091bb3c-6625-4180-93b6-86deec9a0750.gif)
@@ -40,6 +38,12 @@
 pip install jdeskew
 ```
 
+### conda
+
+```bash
+conda create --name jdeskew -c conda-forge jdeskew
+```
+
 ## How-to-use
 
 ### using python
@@ -90,6 +94,8 @@ 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
 
+Link3: https://huggingface.co/papers/2603.05942
+
 
 ## Performance Comparison on DISE 2021
 
@@ -120,7 +126,9 @@ This datasets are built upon three other datasets: DISEC 2013, RVL-CDIP, RDCL 20
 | 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
+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
 
@@ -139,7 +147,3 @@ L. Pham, H. Hoang, X.T. Mai, T. A. Tran, "Adaptive Radial Projection on Fourier
   organization={IEEE}
 }
 ```
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=phamquiluan/jdeskew&type=Date)](https://star-history.com/#phamquiluan/jdeskew&Date)

{jdeskew-0.2.3 → jdeskew-0.4.0}/estimator.py

@@ -9,6 +9,7 @@ from jdeskew.estimator import get_angle
 
 
 class Estimator(BasePredictor):
+
     """Cog estimator."""
 
     def predict(self, input_path: Path = Input()) -> Dict:

jdeskew-0.4.0/jdeskew/estimator.py

@@ -0,0 +1,137 @@
+"""Skew Estimator."""
+import cv2
+import numpy as np
+from typing import Optional
+
+
+def _ensure_gray(image: np.ndarray) -> np.ndarray:
+    try:
+        image = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
+    except cv2.error:
+        pass
+    return image
+
+
+def _ensure_optimal_square(image: np.ndarray) -> np.ndarray:
+    if image is None:
+        raise ValueError("image must not be None")
+    nw = nh = cv2.getOptimalDFTSize(max(image.shape[:2]))
+    output_image = cv2.copyMakeBorder(
+        src=image,
+        top=0,
+        bottom=nh - image.shape[0],
+        left=0,
+        right=nw - image.shape[1],
+        borderType=cv2.BORDER_CONSTANT,
+        value=255,
+    )
+    return output_image
+
+
+def _get_fft_magnitude(image: np.ndarray) -> np.ndarray:
+    gray = _ensure_gray(image)
+    opt_gray = _ensure_optimal_square(gray)
+
+    # thresh
+    opt_gray = cv2.adaptiveThreshold(
+        ~opt_gray, 255, cv2.ADAPTIVE_THRESH_GAUSSIAN_C, cv2.THRESH_BINARY, 15, -10
+    )
+
+    # perform fft - using fft2 to ensure square output
+    dft = np.fft.fft2(opt_gray)
+    shifted_dft = np.fft.fftshift(dft)
+
+    # get the magnitude (module)
+    magnitude = np.abs(shifted_dft)
+    return magnitude
+
+
+def _get_angle_radial_projection(m: np.ndarray, angle_max: Optional[float] = None, num: Optional[int] = None) -> float:
+    """
+    Get angle via radial projection.
+
+    Parameters
+    ----------
+    m : np.ndarray
+        Square FFT magnitude spectrum of the image.
+    angle_max : float, optional
+        Maximum angle to search for, in degrees.
+    num : int, optional
+        Number of angles to generate between 1 degree.
+
+    Returns
+    -------
+    float
+        Estimated skew angle in degrees.
+
+    """
+    if m.shape[0] != m.shape[1]:
+        raise ValueError(f"expected a square matrix, got shape {m.shape}")
+    r = c = m.shape[0] // 2
+
+    if angle_max is None:
+        angle_max = 15.0
+
+    if num is None:
+        num = 20
+
+    tr = np.linspace(-1 * angle_max, angle_max, int(angle_max * num * 2)) / 180 * np.pi
+
+    # Pre-allocate array for better performance
+    li = np.zeros_like(tr)
+
+    for i, t in enumerate(tr):
+        x = np.arange(0, r)
+        y = c + np.int32(x * np.cos(t))
+        x = c + np.int32(-1 * x * np.sin(t))
+        # Use boolean indexing for faster computation
+        valid_indices = (y >= 0) & (y < m.shape[0]) & (x >= 0) & (x < m.shape[1])
+        li[i] = np.sum(m[y[valid_indices], x[valid_indices]])
+
+    a = tr[np.argmax(li)] / np.pi * 180
+
+    if a == -1 * angle_max:
+        return 0.0
+    return float(a)
+
+
+def get_angle(
+    image: np.ndarray,
+    vertical_image_shape: Optional[int] = None,
+    angle_max: Optional[float] = None
+) -> float:
+    """
+    Get angle from a given document image.
+
+    Parameters
+    ----------
+    image : np.ndarray
+        Input image as numpy array.
+    vertical_image_shape : int, optional
+        Resize height for preprocessing.
+    angle_max : float, optional
+        Maximum angle to search for, in degrees.
+
+    Returns
+    -------
+    float
+        Estimated skew angle in degrees.
+
+    """
+    if not isinstance(image, np.ndarray):
+        raise TypeError(f"image must be a numpy array, got {type(image)}")
+
+    # if vertical_image_shape is None:
+    #     vertical_image_shape = 512
+
+    if angle_max is None:
+        angle_max = 15.0
+
+    # resize
+    if vertical_image_shape is not None:
+        ratio = vertical_image_shape / image.shape[0]
+        image = cv2.resize(image, None, fx=ratio, fy=ratio)
+
+    m = _get_fft_magnitude(image)
+    a = _get_angle_radial_projection(m, angle_max=angle_max)
+    return a

{jdeskew-0.2.3 → jdeskew-0.4.0}/jdeskew/utility.py

@@ -3,13 +3,29 @@ import cv2
 
 
 def rotate(image, angle, resize=True, border_mode=None, border_value=None, flags=None):
-    """Rotate input image respect to a given angle.
+    """
+    Rotate input image with respect to a given angle.
+
+    Parameters
+    ----------
+    image : np.ndarray
+        Input image.
+    angle : float
+        Rotation angle in degrees.
+    resize : bool
+        Resize output to the input image shape.
+    border_mode : int, optional
+        cv2.BORDER_REPLICATE or cv2.BORDER_CONSTANT.
+    border_value : optional
+        Border value used when border_mode is cv2.BORDER_CONSTANT.
+    flags : int, optional
+        OpenCV interpolation flags.
+
+    Returns
+    -------
+    np.ndarray
+        Rotated image.
 
-    Params:
-    --------
-    resize (Bool) : resize to input image shape
-    border_mode : cv2.BORDER_REPLICATE, cv2.BORDER_CONSTANT
-    border_value : when border_mode == cv2.BORDER_CONSTANT
     """
     if border_mode is None:
         border_mode = cv2.BORDER_CONSTANT

{jdeskew-0.2.3 → jdeskew-0.4.0}/jdeskew.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: jdeskew
-Version: 0.2.3
+Version: 0.4.0
 Summary: Document Image Skew Estimation using Adaptive Radial Projection
 Author-email: Luan Pham <phamquiluan@gmail.com>
 License: MIT License
@@ -25,6 +25,19 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy
@@ -38,6 +51,7 @@ Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: fastapi; extra == "dev"
 Requires-Dist: uvicorn[standard]; extra == "dev"
 Requires-Dist: python-multipart; extra == "dev"
+Dynamic: license-file
 
 # Document Image Skew Estimation
 
@@ -46,11 +60,9 @@ Requires-Dist: python-multipart; extra == "dev"
 [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Coverage)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/25553a5195074e37a01dd3370c55abaa)](https://www.codacy.com/gh/phamquiluan/jdeskew/dashboard?utm_source=github.com&utm_medium=referral&utm_content=phamquiluan/jdeskew&utm_campaign=Badge_Grade)
 [![Downloads](https://static.pepy.tech/personalized-badge/jdeskew?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads)](https://pepy.tech/project/jdeskew)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/dependency-review.yml/badge.svg)
 ![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-package.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/docker-build-and-push.yml/badge.svg)
-![example workflow](https://github.com/phamquiluan/jdeskew/actions/workflows/python-publish.yml/badge.svg)
-[![PWC](https://img.shields.io/endpoint.svg?url=https://paperswithcode.com/badge/adaptive-radial-projection-on-fourier/document-image-skew-estimation-on-dise-2021)](https://paperswithcode.com/sota/document-image-skew-estimation-on-dise-2021?p=adaptive-radial-projection-on-fourier)
+[![HF Paper](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Paper-yellow)](https://huggingface.co/papers/2603.05942)
+[![HF Dataset](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Dataset-blue)](https://huggingface.co/datasets/phamquiluan/DISE-2021)
 
 
 ![Cover Image](https://user-images.githubusercontent.com/24642166/165683091-4091bb3c-6625-4180-93b6-86deec9a0750.gif)
@@ -81,6 +93,12 @@ Requires-Dist: python-multipart; extra == "dev"
 pip install jdeskew
 ```
 
+### conda
+
+```bash
+conda create --name jdeskew -c conda-forge jdeskew
+```
+
 ## How-to-use
 
 ### using python
@@ -131,6 +149,8 @@ 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
 
+Link3: https://huggingface.co/papers/2603.05942
+
 
 ## Performance Comparison on DISE 2021
 
@@ -161,7 +181,9 @@ This datasets are built upon three other datasets: DISEC 2013, RVL-CDIP, RDCL 20
 | 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
+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
 
@@ -180,7 +202,3 @@ L. Pham, H. Hoang, X.T. Mai, T. A. Tran, "Adaptive Radial Projection on Fourier
   organization={IEEE}
 }
 ```
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=phamquiluan/jdeskew&type=Date)](https://star-history.com/#phamquiluan/jdeskew&Date)

{jdeskew-0.2.3 → jdeskew-0.4.0}/jdeskew.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+.codacy.yaml
 .dockerignore
 .flake8
 .gitignore
@@ -7,6 +8,7 @@ LICENSE
 README.md
 cog.yaml
 estimator.py
+icip_paper.pdf
 main.py
 pyproject.toml
 reproduce.ipynb
@@ -27,6 +29,8 @@ jdeskew.egg-info/PKG-INFO
 jdeskew.egg-info/SOURCES.txt
 jdeskew.egg-info/dependency_links.txt
 jdeskew.egg-info/requires.txt
+jdeskew.egg-info/scm_file_list.json
+jdeskew.egg-info/scm_version.json
 jdeskew.egg-info/top_level.txt
 tests/test.png
 tests/test.py

jdeskew-0.4.0/jdeskew.egg-info/scm_file_list.json

@@ -0,0 +1,33 @@
+{
+  "files": [
+    "main.py",
+    ".dockerignore",
+    "icip_paper.pdf",
+    ".pre-commit-config.yaml",
+    "Dockerfile",
+    "setup.py",
+    "pyproject.toml",
+    ".codacy.yaml",
+    "LICENSE",
+    "reproduce.ipynb",
+    "README.md",
+    ".flake8",
+    ".gitignore",
+    "estimator.py",
+    "cog.yaml",
+    ".github/workflows/dependency-review.yml",
+    ".github/workflows/docker-build-and-push.yml",
+    ".github/workflows/greetings.yml",
+    ".github/workflows/codeql-analysis.yml",
+    ".github/workflows/python-publish.yml",
+    ".github/workflows/label.yml",
+    ".github/workflows/python-package.yml",
+    ".github/workflows/stale.yml",
+    "tests/test.py",
+    "tests/test.png",
+    "jdeskew/utility.py",
+    "jdeskew/__init__.py",
+    "jdeskew/estimator.py",
+    ".circleci/config.yml"
+  ]
+}

jdeskew-0.4.0/jdeskew.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.4.0",
+  "distance": 0,
+  "node": "g4d690b28c74341a36eb33b9b068cc6a29f9bd93c",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-01"
+}

{jdeskew-0.2.3 → jdeskew-0.4.0}/main.py

@@ -6,7 +6,7 @@ app = FastAPI()
 
 @app.post("/predict")
 def predict(file: UploadFile):
-    """simple predict function."""
+    """Simple predict function."""
     # read image
     import cv2
     import numpy as np

{jdeskew-0.2.3 → jdeskew-0.4.0}/pyproject.toml

@@ -11,6 +11,21 @@ name = "jdeskew"
 description = "Document Image Skew Estimation using Adaptive Radial Projection"
 authors = [{name = "Luan Pham", email = "phamquiluan@gmail.com"}]
 license = {file = "LICENSE"}
+requires-python = ">=3.8"
+classifiers = [
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Image Processing",
+]
 dependencies = [
     "numpy",
     "opencv-python-headless"
@@ -64,4 +79,5 @@ exclude = '''
 [tool.pytest.ini_options]
 minversion = "6.0"
 addopts = "-ra -q"
-testpaths = [ "tests/test.png" ]
+testpaths = [ "tests" ]
+python_files = [ "test.py", "test_*.py" ]

jdeskew-0.2.3/jdeskew/estimator.py

@@ -1,112 +0,0 @@
-"""Skew Estimator."""
-import cv2
-import numpy as np
-
-
-def _ensure_gray(image):
-    try:
-        image = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
-    except cv2.error:
-        pass
-    return image
-
-
-def _ensure_optimal_square(image):
-    assert image is not None, image
-    nw = nh = cv2.getOptimalDFTSize(max(image.shape[:2]))
-    output_image = cv2.copyMakeBorder(
-        src=image,
-        top=0,
-        bottom=nh - image.shape[0],
-        left=0,
-        right=nw - image.shape[1],
-        borderType=cv2.BORDER_CONSTANT,
-        value=255,
-    )
-    return output_image
-
-
-def _get_fft_magnitude(image):
-    gray = _ensure_gray(image)
-    opt_gray = _ensure_optimal_square(gray)
-
-    # thresh
-    opt_gray = cv2.adaptiveThreshold(
-        ~opt_gray, 255, cv2.ADAPTIVE_THRESH_GAUSSIAN_C, cv2.THRESH_BINARY, 15, -10
-    )
-
-    # perform fft
-    dft = np.fft.fft2(opt_gray)
-    shifted_dft = np.fft.fftshift(dft)
-
-    # get the magnitude (module)
-    magnitude = np.abs(shifted_dft)
-    return magnitude
-
-
-def _get_angle_radial_projection(m, angle_max=None, num=None, W=None):
-    """Get angle via radial projection.
-
-    Arguments:
-    ------------
-    angle_max : float
-    num : int
-      number of angles to generate between 1 degree
-    """
-    assert m.shape[0] == m.shape[1]
-    r = c = m.shape[0] // 2
-
-    if angle_max is None:
-        pass
-
-    if num is None:
-        num = 20
-
-    tr = np.linspace(-1 * angle_max, angle_max, int(angle_max * num * 2)) / 180 * np.pi
-    profile_arr = tr.copy()
-
-    def f(t):
-        _f = np.vectorize(
-            lambda x: m[c + int(x * np.cos(t)), c + int(-1 * x * np.sin(t))]
-        )
-        _l = _f(range(0, r))
-        val_init = np.sum(_l)
-        return val_init
-
-    vf = np.vectorize(f)
-    li = vf(profile_arr)
-
-    a = tr[np.argmax(li)] / np.pi * 180
-
-    if a == -1 * angle_max:
-        return 0
-    return a
-
-
-def get_angle(
-    image: np.ndarray, vertical_image_shape: int = None, angle_max: float = None
-):
-    """Getting angle from a given document image.
-
-    image : np.ndarray
-    vertical_image_shape : int
-      resize image as preprocessing
-    angle_max : float
-      maximum angle to searching
-    """
-    assert isinstance(image, np.ndarray), image
-
-    # if vertical_image_shape is None:
-    #     vertical_image_shape = 512
-
-    if angle_max is None:
-        angle_max = 15
-
-    # resize
-    if vertical_image_shape is not None:
-        ratio = vertical_image_shape / image.shape[0]
-        image = cv2.resize(image, None, fx=ratio, fy=ratio)
-
-    m = _get_fft_magnitude(image)
-    a = _get_angle_radial_projection(m, angle_max=angle_max)
-    return a