ProductPromotion
Logo

Ruby

made by https://0x3d.site

GitHub - westonplatter/phashion: Ruby wrapper around pHash, the perceptual hash library for detecting duplicate multimedia files
Ruby wrapper around pHash, the perceptual hash library for detecting duplicate multimedia files - westonplatter/phashion
Visit Site

GitHub - westonplatter/phashion: Ruby wrapper around pHash, the perceptual hash library for detecting duplicate multimedia files

GitHub - westonplatter/phashion: Ruby wrapper around pHash, the perceptual hash library for detecting duplicate multimedia files

Phashion

Build Status

Phashion is a Ruby wrapper around the pHash library, "perceptual hash", which detects duplicate and near-duplicate multimedia files (e.g. images, audio, video, though Phashion currently only supports images.). "Near-duplicates" are images that come from the same source and show essentially the same thing, but may have differences in such features as dimensions, bytesizes, lossy-compression artifacts, and color levels.

See an overview of Phashion on Mike's blog.

Installation

You install it just like any other Ruby gem:

gem install phashion

Phashion is somewhat involved to install as it has a few dependencies. Phashion wraps these dependencies into a custom tarball that is built locally just for this gem so you don't have to do anything special. Look in the ext/phashion_ext folder for more details.

Compatibility

Because of this complexity, it is possible the gem install will fail on your platform. Phashion has been tested on:

  • Mac OSX 10.6
  • Mac OSX 10.9
  • Ubuntu 8.04
  • Ubuntu 12.04

Please open a GitHub issue if you have installation problems.

Prerequisites

Linux

  • libjpeg-dev
  • libpng-dev

Mac

  • imagemagick
  • libjpeg (Hombrew, brew install libjpeg; Macports, port install jpeg)
  • libpng (Hombrew, brew install libpng; Macports, port install libpng)

Common Errors

  • ld: library not found for -ljpeg – Did you install libjpeg?
  • ... sh: convert: command not found; sh: gm: command not found – Did you install imagemagick?
  • ... checking for sqlite3ext.h... *** extconf.rb failed *** ... – Did you install libpng-dev and/or libjpeg-dev?

Usage

Testing if one image is a duplicate of another

require 'phashion'
img1 = Phashion::Image.new(filename1)
img2 = Phashion::Image.new(filename2)
img1.duplicate?(img2)
# --> true

Optionally, you can set the minimum Hamming distance in the second argument, an options Hash:

img1.duplicate?(img2, :threshold => 5)
# --> true

img1.duplicate?(img2, :threshold => 0)  
# --> false

Finding the Hamming distance between two images

require 'phashion'
img1 = Phashion::Image.new(filename1)
img2 = Phashion::Image.new(filename2)
img1.distance_from(img2)  
# --> 6

Threshold for dupe-detection

Currently, the maximum Hamming distance between two duplicate images is set at 15. As per mperham's explanation:

A “perceptual hash”is a 64-bit value based on the discrete cosine transform of the image’s frequency spectrum data. Similar images will have hashes that are close in terms of Hamming distance. That is, a binary hash value of 1000 is closer to 0000 than 0011 because it only has one bit different whereas the latter value has two bits different. The duplicate threshold defines how many bits must be different between two hashes for the two associated images to be considered different images. Our testing showed that 15 bits is a good value to start with, it detected all duplicates with a minimum of false positives.

As a reference point, here are the Hamming distances in these test comparisons using /test/jpg/Broccoli_Super_Food.jpg as the source image:

Variation Hamming distance
JPG to PNG 0
Lossy JPG (Photoshop Save for Web quality = 20) 0
Thumbnail (from 500px to 100px) 2
Color correction (saturation +20 w auto-correct) 2
Black and white 2
Extraneous whitespace cropped (500x349 to 466x312) 12
A sloppy rotation of 5 degrees clockwise 14
Horizontally-flipped 32

Gem uses customized pHash 0.9.6

In order to detech duplicate alpha PNGs, the gem uses a custom version of pHash 0.9.6. The customization is limited to only these changes, westonplatter/phash@ff255d2. The gem will be moving back to the pHash master branch once it supports detection of alpha PNG file types.

Testing

To run the test suite:

$ cd phashion
$ bundle install
$ rake compile
$ rake test

Author

Mike Perham, http://mikeperham.com, http://twitter.com/mperham, mperham AT gmail.com

Copyright

Copyright (c) 2010-2014 Mike Perham. See LICENSE for details.

More Resources
to explore the angular.

mail [email protected] to add your project or resources here 🔥.

Related Articles
to learn about angular.

FAQ's
to learn more about Angular JS.

mail [email protected] to add more queries here 🔍.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory