SimilarImageFinder

SimilarImageFinder is a part of OpenNumismat project, so it aims to finding coins images.

This application is designed to explore algorithms for finding similar images using perceptual hashes. The following hash types are currently supported:

• Average hashing
• Perceptual hashing
• Difference hashing
• Wavelet hashing
• HSV color hashing
• Crop-resistant hashing
• Marr-Hildreth hashing
• Radial variance hashing
• Block mean hashing
• Color moment hashing
• PDQ hashing

Perceptual hashing works well for paper (stamps, banknotes, postcards), but does not work with 3D objects (coins) due to glare. To avoid this filters and preprocessing are used. For coins photos best results are obtained by cropping the image to a 256px square, highlighting the feature points with orientedBRIEF and calculating the perceptual hash.

For hash calcualtion uses labraries ImageHash, OpenCV, pdqhash and blockhash. For filtering images uses OpenCV labrary.

Download

Latest version for Windows 10 and later

For run from source code

Run GUI:

pip3 install -r requirements.txt
python3 src/run.py

Run CLI:

python3 src/cli.py [-h] [--file FILE] --similar_files SIMILAR_FILES [SIMILAR_FILES ...] --folder FOLDER
                   --hash
                   {ahash,phash,dhash,whash,ahash_cv,blockhash,mhhash,phash_cv,radialhash,pdqhash,crop_resistant_hash,bhash,colorhash,colorhash_cv}
                   [{ahash,phash,dhash,whash,ahash_cv,blockhash,mhhash,phash_cv,radialhash,pdqhash,crop_resistant_hash,bhash,colorhash,colorhash_cv} ...]
                   [--filter FILTER [FILTER ...]]

options:
  -h, --help        show this help message and exit
  --file FILE       File for search
  --similar_files SIMILAR_FILES [SIMILAR_FILES ...]
                    Group of similar image files in FOLDER
  --folder FOLDER   Folder for scan similarity images
  --hash {ahash,phash,dhash,whash,ahash_cv,blockhash,mhhash,phash_cv,radialhash,pdqhash,crop_resistant_hash,bhash,colorhash,colorhash_cv} [{ahash,phash,dhash,whash,ahash_cv,blockhash,mhhash,phash_cv,radialhash,pdqhash,crop_resistant_hash,bhash,colorhash,colorhash_cv} ...]
                    Hash method
  --filter FILTER [FILTER ...]
                    List of preprocessing filters. Can be any combination of none,sq,sq512,sq256,clahe,threshold,laplacian,sobel,sobel_x,filter2D,sketch,pencil,canny,segments,fast,good,corner,orb,sift joined with '-'

Usage examples:
  cli.py --similar_files "01.jpg" "02.jpg" --folder C:/SimilarImageFinder/ --hash phash --preprocess corner sq-sketch
  cli.py --similar_files "01.jpg" "02.jpg" --file C:/similar_image.jpg --folder C:/SimilarImageFinder/ --hash phash pdqhash