gradupe 2.1.0

Sobel Gradient Image Deduplication

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 library is written in Python using OpenCV, NumPy, and Numba (LLVM JIT). The CLI is written with Rich and Typer.

Install the CLI tool with pip install gradupe. Refer to gradupe --help for usage instructions.

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 caught 100+ duplicate pairs that iCloud Photos failed to detect.