首页
/ Phashion 技术文档

Phashion 技术文档

2024-12-20 12:32:59作者:郁楠烈Hubert

本文档旨在帮助用户安装、使用以及详细了解 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

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

登录后查看全文
热门项目推荐