Skip to content
This repository was archived by the owner on Oct 3, 2025. It is now read-only.

wavim/gradupe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GraDupe Icon
GraDupe

Sobel Gradient Image Deduplication

Motivation

Classical algorithms based on image hashes can be inaccurate. Innovative ones based on RNNs can be inefficient. As the demand for image storage increases rapidly over the decade, we need a prompt solution that combines the benefits of both.

Solution

At one point, Sobel gradients occurred to me as a decent fingerprint for an image. Similar to finite differences and derivatives, two distinct images bear the same gradient only if they differ by a constant. By reading an image in grayscale, we obtain a 2D matrix suitable for Sobel operators.

Images of different dimensions are downscaled into a square grid. Although convolutions are blazingly fast on modern hardware, this is done to unify dimensions and speed up diffing. After downscaling, there remains a sufficient amount of informative bits for diffing in the next step.

Sobel operators are traditionally used for edge detection, but their nature lies in differentiating an image. Computing the Sobel gradient of an image in both the x and y directions yields two matrices, which we flatten and concatenate into a contiguous array.

The gradients are thresholded into bitmasks since Hamming distance can be optimized using SIMD XOR instructions, making it magnitudes faster than Euclidean norm. By mapping sub-indices of pairs into combinatorial indices, a densely packed array can be used as a distance matrix, saving memory and enabling parallel computation.

The single flat distance array can be thresholded into a boolean mask with SIMD instructions. All that remains is to compress the image combinations with the mask (combinatorial indexing ensures correct correspondence), resulting in a list of duplicate images with the specified threshold.

Implementation

The tool is written in pure Python. The internal library used OpenCV, NumPy, and Numba (LLVM JIT). The CLI is built with Typer and Rich.

Get the CLI with pip install gradupe, refer to gradupe --help for usage instructions. Optionally, install Intel's TBB (Threading Building Blocks) libraries on your device to enable dynamic scheduling (computational load of distance matrix is imbalanced). Run numba -s | grep TBB to check TBB presence, refer to instructions if TBB is not found.

In practice, the tool proves extremely efficient and accurate. It finishes comparing 2000 images in under 0.1 seconds on my Intel(R) Core(TM) i5-11320H laptop and found 100 duplicate pairs that iCloud Photos failed to detect.

About

Sobel Gradient Image Deduplication

Topics

Resources

License

Stars

Watchers

Forks

Languages