Phashion 技术文档

本文档旨在帮助用户安装、使用以及详细了解 Phashion 项目。Phashion 是一个 Ruby 的封装库，用于 pHash 库，能够检测多媒体文件（例如图片、音频、视频）的重复和近似重复项。目前，Phashion 仅支持图片。

安装指南

安装 Phashion 与安装其他 Ruby gem 类似：

gem install phashion

Phashion 的安装相对复杂，因为它有一些依赖项。Phashion 将这些依赖项打包成一个自定义的 tarball，以便在本地构建该 gem，无需进行特殊操作。详细信息请查看 ext/phashion_ext 文件夹。

兼容性

由于这种复杂性，gem 安装可能会在你的平台上失败。Phashion 已经在以下平台上进行了测试：

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

如果你在安装过程中遇到问题，请在 GitHub 上打开一个 issue。

预先条件

Linux:

• libjpeg-dev
• libpng-dev

Mac:

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

常见错误

• ld: library not found for -ljpeg — 你是否安装了 libjpeg？
• ... sh: convert: command not found; sh: gm: command not found — 你是否安装了 imagemagick？
• ... checking for sqlite3ext.h... *** extconf.rb failed *** ... — 你是否安装了 libpng-dev 和/或 libjpeg-dev？

项目使用说明

检查两张图片是否为重复

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

可选地，你可以在第二个参数中设置最小汉明距离，这是一个选项哈希：

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

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

计算两张图片的汉明距离

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

重复检测的阈值

目前，两个重复图片之间的最大汉明距离设置为 15。根据 mperham 的解释：

“感知哈希”是基于图像频率谱数据的离散余弦变换得到的 64 位值。相似的图像将具有接近的哈希值，在汉明距离上。即，二进制哈希值 1000 比值为 0011 更接近 0000，因为它只有一个位不同，而后者有两个位不同。重复阈值定义了两个哈希之间必须有多少个位不同，才能将两个关联的图像视为不同的图像。我们的测试表明，15 个位是一个不错的起始值，它可以检测到所有重复项，最少出现假阳性。

以下是一些使用 /test/jpg/Broccoli_Super_Food.jpg 作为源图像的测试比较的汉明距离：

变体	汉明距离
JPG 转换为 PNG	0
有损 JPG (Photoshop 保存为网页质量 = 20)	0
缩略图 (从 500px 转换为 100px)	2
色彩校正 (饱和度 +20 自动校正)	2
黑白	2
额外的空白裁剪 (500x349 裁剪为 466x312)	12
5 度顺时针旋转的模糊图像	14
水平翻转	32

项目 API 使用文档

Phashion 提供了一些简单的方法用于图像比较：

• Phashion::Image.new(filename)：创建一个新的 Phashion 图像实例。
• duplicate?(other_image, options = {})：检查当前图像是否与另一个图像重复。
• distance_from(other_image)：计算当前图像与另一个图像的汉明距离。

项目安装方式

如前所述，Phashion 可以通过 Ruby gem 的方式安装：

gem install phashion

请确保你的系统满足了上述预先条件，以确保安装过程顺利进行。