The module brings implementations of different image hashing algorithms.

クラス
class	cv::img_hash::AverageHash
	入力画像の平均ハッシュ値を計算します。[【詳解】（英語］
class	cv::img_hash::BlockMeanHash
	ブロック平均に基づいて画像のハッシュを計算します[【詳解】（英語］
class	cv::img_hash::ColorMomentHash
	カラーモーメントに基づく画像ハッシュ。[【詳解】（英語］
class	cv::img_hash::ImgHashBase
	画像のハッシュアルゴリズムの基底クラス[【詳解】（英語］
class	cv::img_hash::MarrHildrethHash
	Marr-Hildreth Operator Based Hash，最も遅いが識別性が高い．[【詳解】（英語］
class	cv::img_hash::PHash
	pHash[【詳解】（英語］
class	cv::img_hash::RadialVarianceHash
	ラドン変換に基づく画像ハッシュです。[【詳解】（英語］

列挙型
enum	cv::img_hash::BlockMeanHashMode { cv::img_hash::BLOCK_MEAN_HASH_MODE_0 = 0 , cv::img_hash::BLOCK_MEAN_HASH_MODE_1 = 1 }

関数
CV_EXPORTS_W void	cv::img_hash::averageHash (cv::InputArray inputArr, cv::OutputArray outputArr)
	計算方法img_hash::AverageHash1回の呼び出しで[【詳解】（英語］
CV_EXPORTS_W void	cv::img_hash::blockMeanHash (cv::InputArray inputArr, cv::OutputArray outputArr, int mode=BLOCK_MEAN_HASH_MODE_0)
	入力画像のブロック平均ハッシュを求めます．[【詳解】（英語］
CV_EXPORTS_W void	cv::img_hash::colorMomentHash (cv::InputArray inputArr, cv::OutputArray outputArr)
	Computes color moment hash of the input, the algorithm is come from the paper "Perceptual Hashing for Color Images Using Invariant Moments" [【詳解】（英語］
CV_EXPORTS_W void	cv::img_hash::marrHildrethHash (cv::InputArray inputArr, cv::OutputArray outputArr, float alpha=2.0f, float scale=1.0f)
	入力画像の平均ハッシュ値を計算します。[【詳解】（英語］
CV_EXPORTS_W void	cv::img_hash::pHash (cv::InputArray inputArr, cv::OutputArray outputArr)
	入力画像のハッシュ値を計算します．[【詳解】（英語］
CV_EXPORTS_W void	cv::img_hash::radialVarianceHash (cv::InputArray inputArr, cv::OutputArray outputArr, double sigma=1, int numOfAngleLine=180)
	入力画像の半径方向の分散のハッシュ値を求めます．[【詳解】（英語］

詳解

Provide algorithms to extract the hash of images and fast way to figure out most similar images in huge data set.

Namespace for all functions is cv::img_hash.

Supported Algorithms

• Average hash (also called Different hash)
• PHash (also called Perceptual hash)
• Marr Hildreth Hash
• Radial Variance Hash
• Block Mean Hash (modes 0 and 1)
• Color Moment Hash (this is the one and only hash algorithm resist to rotation attack(-90~90 degree))

You can study more about image hashing from following paper and websites:

• "Implementation and benchmarking of perceptual image hash functions" [zauner2010implementation]
• "Looks Like It" [lookslikeit]

Code Example

Performance under different attacks

Speed comparison with PHash library (100 images from ukbench)

As you can see, hash computation speed of img_hash module outperform PHash library a lot.

PS : I do not list out the comparison of Average hash, PHash and Color Moment hash, because I cannot find them in PHash.

Motivation

Collects useful image hash algorithms into opencv, so we do not need to rewrite them by ourselves again and again or rely on another 3rd party library(ex : PHash library). BOVW or correlation matching are good and robust, but they are very slow compare with image hash, if you need to deal with large scale CBIR(content based image retrieval) problem, image hash is a more reasonable solution.

More info

You can learn more about img_hash modules from following links, these links show you how to find similar image from ukbench dataset, provide thorough benchmark of different attacks(contrast, blur, noise(gaussion,pepper and salt), jpeg compression, watermark, resize).

Introduction to image hash module of opencv Speed up image hashing of opencv(img_hash) and introduce color moment hash

Contributors

Tham Ngap Wei, thamn.nosp@m.gapw.nosp@m.ei@gm.nosp@m.ail..nosp@m.com

列挙型詳解

BlockMeanHashMode

enum cv::img_hash::BlockMeanHashMode

列挙値
ブロック平均法_ハッシュ_モード_0	少ないブロックを用いて，16*16/8のハッシュ値を生成します．
ブロック平均ハッシュモード_1	ブロック数(ステップサイズ/2)を使用し，31*31/8 + 1のハッシュ値を生成する

関数詳解

averageHash()

CV_EXPORTS_W void cv::img_hash::averageHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr
	)

計算方法img_hash::AverageHash1回の呼び出しで

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 のいずれかです．
outputArr	入力画像のハッシュ値は，16進数で表され，戻り値は CV_8U となります．

blockMeanHash()

CV_EXPORTS_W void cv::img_hash::blockMeanHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr,
		int	mode = BLOCK_MEAN_HASH_MODE_0
	)

入力画像のブロック平均ハッシュを求めます．

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 のいずれかです．
outputArr	入力画像のハッシュ値は，16進数で表され，戻り値は CV_8U となります．
mode	モード

colorMomentHash()

CV_EXPORTS_W void cv::img_hash::colorMomentHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr
	)

Computes color moment hash of the input, the algorithm is come from the paper "Perceptual Hashing for Color Images Using Invariant Moments"

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 のいずれかです．
outputArr	CV_64F(double)型のハッシュ値を42個持ちます．

marrHildrethHash()

CV_EXPORTS_W void cv::img_hash::marrHildrethHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr,
		float	alpha = 2.0f,
		float	scale = 1.0f
	)

入力画像の平均ハッシュ値を計算します。

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 でなければいけません．
outputArr	入力画像のハッシュ値は，16進数で表され，戻り値は CV_8U となります．
alpha	marrウェーブレットのスケールファクタを指定します（デフォルトは2）．
scale	int スケールファクターのレベル(デフォルト=1)

pHash()

CV_EXPORTS_W void cv::img_hash::pHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr
	)

入力画像のハッシュ値を計算します．

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 でなければいけません．
outputArr	入力画像のハッシュ値，これは8個の値を含みます．

radialVarianceHash()

CV_EXPORTS_W void cv::img_hash::radialVarianceHash	(	cv::InputArray	inputArr,
		cv::OutputArray	outputArr,
		double	sigma = 1,
		int	numOfAngleLine = 180
	)

入力画像の半径方向の分散のハッシュ値を求めます．

引数

inputArr	ハッシュ値を計算したい入力画像．タイプは CV_8UC4, CV_8UC3, CV_8UC1 でなければいけません．
outputArr	入力画像のハッシュ値
sigma	ガウシアンカーネルの標準偏差
numOfAngleLine	考慮する角度の数