LIRE原理与源码分析（二）——相关接口
1. LIRE原理与源码分析（二）—— 代码结构
2. LIRE原理与源码分析（二）—— 相关接口
上一篇文章介绍了LIRE的基本内容和源码的代码结构。本文针对LIRE中主要的三个接口（LireFeature、DocumentBuilder、ImageSearcher）的相关内容进行分析。
LireFeature
LireFeature是一个图像特征的Interface，其中定义了很多跟图像特征相关的方法，最重要的两个是extract()和getDistance()。extract()方法负责从图像矩阵表示中提取出所需要的特征变量，而getDistance()用于比较两个特征之间的距离，用于排序检索结果。任何具体特征类都需要实现这个接口。在LIRE 0.9.5中实现了约28种特征。
图1
以同一个包中的SimpleColorHistogram这个具体的特征实现类为例，它实现了LireFeature接口，其extract方法就是从图像文件中提取8bit的RGB表示信息直方统计图，用它做特征来检索图像。它的图像之间的距离定义有多种情况（用户可以自己配置选择），例如dist_1就是，dist_2是平方差，还有jsd和tanmoto等距离衡量方式等。但是有些的特征的计算比较复杂，如SiftFeature，则是通过Extractor类进行特征提取。
DocumentBuilder
提取完特征以后，就可以根据提取的出来的特征来构建索引，并将之存储到索引文件中以待检索。索引创建的主要使用的类和接口如图2所示，构建索引的实现设计采用了工厂模式，程序中通常通过DocumentBuilderFactory来创建索引，Factory通过具体的类来对图像进行操作和构建索引。
图2
DocumentBuilder接口中定义了三个方法：
createDescriptorFields(BufferedImage image)用来填充Document对象的feature fields字段。
createDocument(BufferedImage image, String identifier)和createDocument(InputStream image, String identifier)则总来创建Document对象。
AbstractDocumentBuilder是一个实现了DocumentBuilder接口的抽象类，其中给出了两个createDocument方法的实现，其中createDocument(InputStream image, String identifier)是通过调用createDocument(BufferedImage image, String identifier)实现的。
... ... ...
public static DocumentBuilder getColorLayoutBuilder() {
return new GenericDocumentBuilder(ColorLayout.class, DocumentBuilder.FIELD_NAME_COLORLAYOUT);
}
public static DocumentBuilder getEdgeHistogramBuilder() {
return new GenericDocumentBuilder(EdgeHistogram.class, DocumentBuilder.FIELD_NAME_EDGEHISTOGRAM);
}
public static DocumentBuilder getScalableColorBuilder() {
return new GenericDocumentBuilder(ScalableColor.class, DocumentBuilder.FIELD_NAME_SCALABLECOLOR);
}
public static DocumentBuilder getAutoColorCorrelogramDocumentBuilder() {
return new GenericDocumentBuilder(AutoColorCorrelogram.class, DocumentBuilder.FIELD_NAME_AUTOCOLORCORRELOGRAM, GenericDocumentBuilder.Mode.Fast);
}
public static DocumentBuilder getCEDDDocumentBuilder() {
return new GenericDocumentBuilder(CEDD.class, DocumentBuilder.FIELD_NAME_CEDD);
}
public static DocumentBuilder getHashingCEDDDocumentBuilder() {
return new GenericDocumentBuilder(CEDD.class, DocumentBuilder.FIELD_NAME_CEDD, true);
}
public static DocumentBuilder getFCTHDocumentBuilder() {
return new GenericDocumentBuilder(FCTH.class, DocumentBuilder.FIELD_NAME_FCTH, GenericDocumentBuilder.Mode.Fast);
}
public static DocumentBuilder getJCDDocumentBuilder() {
return new GenericDocumentBuilder(JCD.class, DocumentBuilder.FIELD_NAME_JCD);
}
... ... ...ImageSearcher
ImageSearcher的设计与DocumentBuilder的类似，类关系图如图3所示。ImageSearcher接口中定义了三个方法：search、findDuplicates和relevanceFeedback，抽象类AbstractImageSearcher实现了其中的两个，search即为进行相似查找时使用的方法。
图3
下面的代码段是ImageSearcherFactory类的部分代码。对于具体特征的ImageSearcher，通过调用工厂类ImageSearcherFactory的createXXXImageSearcher方法，并传入具体的特征类XXX.class来创建，该方法返回一个GenericFastImageSearcher对象，该对象根据传入的不同特征类，调用本类的search、getDistance等方法进行相关操作。
... ... ...
public static ImageSearcher createAutoColorCorrelogramImageSearcher(int maximumHits) {
return new GenericFastImageSearcher(maximumHits, AutoColorCorrelogram.class, DocumentBuilder.FIELD_NAME_AUTOCOLORCORRELOGRAM);
}
public static ImageSearcher createCEDDImageSearcher(int maximumHits) {
return new GenericFastImageSearcher(maximumHits, CEDD.class, DocumentBuilder.FIELD_NAME_CEDD);
}
public static ImageSearcher createHashingCEDDImageSearcher(int maximumHits) {
return new BitSamplingImageSearcher(maximumHits, DocumentBuilder.FIELD_NAME_CEDD,
DocumentBuilder.FIELD_NAME_CEDD+"_hash", new CEDD());
}
public static ImageSearcher createFCTHImageSearcher(int maximumHits) {
return new GenericFastImageSearcher(maximumHits, FCTH.class, DocumentBuilder.FIELD_NAME_FCTH);
}
public static ImageSearcher createJCDImageSearcher(int maximumHits) {
return new GenericFastImageSearcher(maximumHits, JCD.class, DocumentBuilder.FIELD_NAME_JCD);
}
public static ImageSearcher createJpegCoefficientHistogramImageSearcher(int maximumHits) {
return new GenericFastImageSearcher(maximumHits, JpegCoefficientHistogram.class, DocumentBuilder.FIELD_NAME_JPEGCOEFFS);
}
... ... ...