pHash 1.0.0

data/spec/data/audiophash.h-0.9.3.txt

@@ -0,0 +1,111 @@
+/*
+
+    pHash, the open source perceptual hash library
+    Copyright (C) 2009 Aetilius, Inc.
+    All rights reserved.
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+    Evan Klinger - eklinger@phash.org
+    D Grant Starkweather - dstarkweather@phash.org
+
+*/
+
+#ifndef _AUDIO_PHASH_H
+#define _AUDIO_PHASH_H
+
+#include <limits.h>
+#include <math.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <algorithm>
+#include "pHash.h"
+
+extern "C" {
+	#include "./libavformat/avformat.h"
+	#include "./libavcodec/avcodec.h"
+	#include "./libswscale/swscale.h"
+        #include "ph_fft.h"
+}
+
+/*  /brief count number of samples in file
+ *  
+ *  /param filename - path and file name of audio file
+ *  /param sr - sample rate conversion
+ *  /param channels - channels number conversion
+ *  /return int count of number of sampels, negative for error
+*/
+int ph_count_samples(const char *filename, int sr,int channels);
+
+
+
+
+/* /brief read audio 
+ *
+ * /param filename - path and name of audio file to read
+ * /param sr - sample rate conversion
+ * /param channels - nb channels to convert to (always 1) unused
+ * /param buf - preallocated buffer 
+ * /param buflen - (in/out) param for buf length
+ * /param nbsecs - float value for duration (in secs) to read from file
+ * /return float* - float pointer to start of buffer - one channel of audio, NULL if error
+ */
+float* ph_readaudio(const char *filename, int sr, int channels, float *sigbuf, int &buflen, const float nbsecs = 0);
+
+/* /brief audio hash calculation
+ * purpose: hash calculation for each frame in the buffer.
+ *          Each value is computed from successive overlapping frames of the input buffer. 
+ *          The value is based on the bark scale values of the frame fft spectrum. The value
+ *          computed from temporal and spectral differences on the bark scale.
+ * 
+ * /param buf - pointer to start of buffer
+ * /param N   - length of buffer
+ * /param sr  - sample rate on which to base the audiohash
+ * /param nb_frames - (out) number of frames in audio buf and length of audiohash buffer returned
+ * /return uint32 pointer to audio hash, NULL for error
+*/
+uint32_t* ph_audiohash(float *buf, int nbbuf, const int sr, int &nbframes);
+
+DP **ph_audio_hashes(char *files[], int count, int sr = 8000, int channels = 1, int threads = 0);
+
+/* /brief bit count set bits in 32bit variable
+ * /param n 
+ * /return int number of bits set to 1, negative if error
+ */
+int ph_bitcount(uint32_t n);
+
+
+/* /brief compare 2 hash blocks 
+ * /param ptr_blockA - pointer to the first block
+ * /param ptr_blockB - pointer to the second block
+ * /param block_size - length of both blocks to compare
+ * /return double bit error rate (ber) from comparing two blocks, neg for error
+ */
+double ph_compare_blocks(const uint32_t *ptr_blockA,const uint32_t *ptr_blockB, const int block_size);
+
+
+/* /brief distance function between two hashes
+ *
+ * /param hash_a - first hash
+ * /param Na     - length of first hash
+ * /param hash_b - second hash
+ * /param Nb     - length of second hash
+ * /param threshold - threshold value to compare successive blocks, 0.25, 0.30, 0.35
+ * /param block_size - length of block_size, 256
+ * /param Nc     - (out) length of confidence score vector
+ * /return double - ptr to confidence score vector
+ */
+double* ph_audio_distance_ber(uint32_t *hash_a , const int Na, uint32_t *hash_b, const int Nb, const float threshold, const int block_size, int &Nc);
+
+#endif

data/spec/data/audiophash.h-0.9.4.txt

@@ -0,0 +1,108 @@
+/*
+
+    pHash, the open source perceptual hash library
+    Copyright (C) 2009 Aetilius, Inc.
+    All rights reserved.
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+    Evan Klinger - eklinger@phash.org
+    D Grant Starkweather - dstarkweather@phash.org
+
+*/
+
+#ifndef _AUDIO_PHASH_H
+#define _AUDIO_PHASH_H
+
+#include <limits.h>
+#include <math.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <algorithm>
+#include "pHash.h"
+
+extern "C" {
+#include "ph_fft.h"
+}
+
+/*  /brief count number of samples in file
+ *  
+ *  /param filename - path and file name of audio file
+ *  /param sr - sample rate conversion
+ *  /param channels - channels number conversion
+ *  /return int count of number of sampels, negative for error
+*/
+int ph_count_samples(const char *filename, int sr,int channels);
+
+
+
+
+/* /brief read audio 
+ *
+ * /param filename - path and name of audio file to read
+ * /param sr - sample rate conversion
+ * /param channels - nb channels to convert to (always 1) unused
+ * /param buf - preallocated buffer 
+ * /param buflen - (in/out) param for buf length
+ * /param nbsecs - float value for duration (in secs) to read from file
+ * /return float* - float pointer to start of buffer - one channel of audio, NULL if error
+ */
+float* ph_readaudio(const char *filename, int sr, int channels, float *sigbuf, int &buflen, const float nbsecs = 0);
+
+/* /brief audio hash calculation
+ * purpose: hash calculation for each frame in the buffer.
+ *          Each value is computed from successive overlapping frames of the input buffer. 
+ *          The value is based on the bark scale values of the frame fft spectrum. The value
+ *          computed from temporal and spectral differences on the bark scale.
+ * 
+ * /param buf - pointer to start of buffer
+ * /param N   - length of buffer
+ * /param sr  - sample rate on which to base the audiohash
+ * /param nb_frames - (out) number of frames in audio buf and length of audiohash buffer returned
+ * /return uint32 pointer to audio hash, NULL for error
+*/
+uint32_t* ph_audiohash(float *buf, int nbbuf, const int sr, int &nbframes);
+
+DP **ph_audio_hashes(char *files[], int count, int sr = 8000, int channels = 1, int threads = 0);
+
+/* /brief bit count set bits in 32bit variable
+ * /param n 
+ * /return int number of bits set to 1, negative if error
+ */
+int ph_bitcount(uint32_t n);
+
+
+/* /brief compare 2 hash blocks 
+ * /param ptr_blockA - pointer to the first block
+ * /param ptr_blockB - pointer to the second block
+ * /param block_size - length of both blocks to compare
+ * /return double bit error rate (ber) from comparing two blocks, neg for error
+ */
+double ph_compare_blocks(const uint32_t *ptr_blockA,const uint32_t *ptr_blockB, const int block_size);
+
+
+/* /brief distance function between two hashes
+ *
+ * /param hash_a - first hash
+ * /param Na     - length of first hash
+ * /param hash_b - second hash
+ * /param Nb     - length of second hash
+ * /param threshold - threshold value to compare successive blocks, 0.25, 0.30, 0.35
+ * /param block_size - length of block_size, 256
+ * /param Nc     - (out) length of confidence score vector
+ * /return double - ptr to confidence score vector
+ */
+double* ph_audio_distance_ber(uint32_t *hash_a , const int Na, uint32_t *hash_b, const int Nb, const float threshold, const int block_size, int &Nc);
+
+#endif

data/spec/phash_spec.rb

@@ -0,0 +1,43 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe :Phash do
+  data_dir = FSPath(__FILE__).dirname / 'data'
+
+  shared_examples :similarity do
+    it "should return valid similarities" do
+      collection.combination(2) do |a, b|
+        if a.path.main_name == b.path.main_name
+          (a % b).should > 0.8
+        else
+          (a % b).should <= 0.5
+        end
+      end
+    end
+
+    it "should return same similarity if swapping instances" do
+      collection.combination(2) do |a, b|
+        (a % b).should == (b % a)
+      end
+    end
+  end
+
+  describe :Audio do
+    let(:collection){ Phash::Audio.for_paths(data_dir.glob('*.mp3')) }
+    include_examples :similarity
+  end
+
+  describe :Image do
+    let(:collection){ Phash::Image.for_paths(data_dir.glob('**/*.{jpg,png}')) }
+    include_examples :similarity
+  end
+
+  describe :Text do
+    let(:collection){ Phash::Text.for_paths(data_dir.glob('*.txt')) }
+    include_examples :similarity
+  end
+
+  describe :Video do
+    let(:collection){ Phash::Video.for_paths(data_dir.glob('*.mp4')) }
+    include_examples :similarity
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'rspec'
+require 'fspath'
+require 'phash'
+
+class FSPath
+  def main_name
+    basename.to_s.split('-', 2).first
+  end
+end

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification 
+name: pHash
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Ivan Kuchin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-25 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: fspath
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- LICENSE.txt
+- README.markdown
+- audiophash.diff
+- lib/phash.rb
+- lib/phash/all.rb
+- lib/phash/audio.rb
+- lib/phash/image.rb
+- lib/phash/text.rb
+- lib/phash/video.rb
+- pHash.gemspec
+- spec/data/audiophash.cpp-0.9.3.txt
+- spec/data/audiophash.cpp-0.9.4.txt
+- spec/data/audiophash.h-0.9.3.txt
+- spec/data/audiophash.h-0.9.4.txt
+- spec/data/hal9000-m.mp3
+- spec/data/hal9000-o.mp3
+- spec/data/jug-0-10.jpg
+- spec/data/jug-0-120.png
+- spec/data/jug-0-50.jpg
+- spec/data/jug-0-70.jpg
+- spec/data/jug-1-10.jpg
+- spec/data/jug-1-120.png
+- spec/data/jug-1-50.jpg
+- spec/data/jug-1-70.jpg
+- spec/data/jug-120.mp4
+- spec/data/jug-150.mp4
+- spec/data/jug-180.mp4
+- spec/data/jug-2-10.jpg
+- spec/data/jug-2-120.png
+- spec/data/jug-2-50.jpg
+- spec/data/jug-2-70.jpg
+- spec/data/mouse-0-10.jpg
+- spec/data/mouse-0-120.png
+- spec/data/mouse-0-50.jpg
+- spec/data/mouse-0-70.jpg
+- spec/data/mouse-1-10.jpg
+- spec/data/mouse-1-120.png
+- spec/data/mouse-1-50.jpg
+- spec/data/mouse-1-70.jpg
+- spec/data/mouse-120.mp4
+- spec/data/mouse-150.mp4
+- spec/data/mouse-180.mp4
+- spec/data/mouse-2-10.jpg
+- spec/data/mouse-2-120.png
+- spec/data/mouse-2-50.jpg
+- spec/data/mouse-2-70.jpg
+- spec/data/scream-m.mp3
+- spec/data/scream-o.mp3
+- spec/data/vader-m.mp3
+- spec/data/vader-o.mp3
+- spec/phash_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/toy/pHash
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: pHash
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Use pHash with ruby
+test_files: 
+- spec/data/audiophash.cpp-0.9.3.txt
+- spec/data/audiophash.cpp-0.9.4.txt
+- spec/data/audiophash.h-0.9.3.txt
+- spec/data/audiophash.h-0.9.4.txt
+- spec/data/hal9000-m.mp3
+- spec/data/hal9000-o.mp3
+- spec/data/jug-0-10.jpg
+- spec/data/jug-0-120.png
+- spec/data/jug-0-50.jpg
+- spec/data/jug-0-70.jpg
+- spec/data/jug-1-10.jpg
+- spec/data/jug-1-120.png
+- spec/data/jug-1-50.jpg
+- spec/data/jug-1-70.jpg
+- spec/data/jug-120.mp4
+- spec/data/jug-150.mp4
+- spec/data/jug-180.mp4
+- spec/data/jug-2-10.jpg
+- spec/data/jug-2-120.png
+- spec/data/jug-2-50.jpg
+- spec/data/jug-2-70.jpg
+- spec/data/mouse-0-10.jpg
+- spec/data/mouse-0-120.png
+- spec/data/mouse-0-50.jpg
+- spec/data/mouse-0-70.jpg
+- spec/data/mouse-1-10.jpg
+- spec/data/mouse-1-120.png
+- spec/data/mouse-1-50.jpg
+- spec/data/mouse-1-70.jpg
+- spec/data/mouse-120.mp4
+- spec/data/mouse-150.mp4
+- spec/data/mouse-180.mp4
+- spec/data/mouse-2-10.jpg
+- spec/data/mouse-2-120.png
+- spec/data/mouse-2-50.jpg
+- spec/data/mouse-2-70.jpg
+- spec/data/scream-m.mp3
+- spec/data/scream-o.mp3
+- spec/data/vader-m.mp3
+- spec/data/vader-o.mp3
+- spec/phash_spec.rb
+- spec/spec_helper.rb
+has_rdoc: