org.openimaj.image.processing.face.feature.comparison

Class DoGSIFTFeatureComparator

java.lang.Object

org.openimaj.image.processing.face.feature.comparison.DoGSIFTFeatureComparator

All Implemented Interfaces:

FacialFeatureComparator<DoGSIFTFeature>, ReadableBinary, ReadWriteableBinary, WriteableBinary, DistanceComparator<DoGSIFTFeature>

@Reference(type=Inproceedings,
           author={"Ozkan, Derya","Duygulu, Pinar"},
           title="Finding people frequently appearing in news",
           year="2006",
           booktitle="Proceedings of the 5th international conference on Image and Video Retrieval",
           pages={"173","","182"},
           url="http://dx.doi.org/10.1007/11788034_18",
           publisher="Springer-Verlag",
           series="CIVR\'06",
           customData={"isbn","3-540-36018-2, 978-3-540-36018-6","location","Tempe, AZ","numpages","10","doi","10.1007/11788034_18","acmid","2164555","address","Berlin, Heidelberg"})
public class DoGSIFTFeatureComparator
extends Object
implements FacialFeatureComparator<DoGSIFTFeature>

A FacialFeatureComparator for comparing DoGSIFTFeatures.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Constructor Summary

Constructors

Constructor and Description
DoGSIFTFeatureComparator()

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader() Header for binary input.
static ModelDistanceCheck	buildDefaultDistanceCheck() Build a DistanceCheck for the spatial layout of matching normalised facial features.
double	compare(DoGSIFTFeature query, DoGSIFTFeature target) Compare two objects, returning a score or distance.
boolean	isDistance()
void	readBinary(DataInput in) Read internal state from in.
void	writeBinary(DataOutput out) Write the content of this as binary to out.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DoGSIFTFeatureComparator

public DoGSIFTFeatureComparator()

Method Detail

readBinary

public void readBinary(DataInput in)
                throws IOException

Description copied from interface: ReadableBinary

Read internal state from in.

Specified by:

readBinary in interface ReadableBinary

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

binaryHeader

public byte[] binaryHeader()

Description copied from interface: ReadableBinary

Header for binary input. Will be automatically read by IOUtils when using readBinary().

Specified by:

binaryHeader in interface ReadableBinary

Specified by:

binaryHeader in interface WriteableBinary

Returns:

header

writeBinary

public void writeBinary(DataOutput out)
                 throws IOException

Description copied from interface: WriteableBinary

Write the content of this as binary to out.

Specified by:

writeBinary in interface WriteableBinary

Parameters:

out - sink to write to

Throws:

IOException - an error writing to out

buildDefaultDistanceCheck

public static ModelDistanceCheck buildDefaultDistanceCheck()

Build a DistanceCheck for the spatial layout of matching normalised facial features. The parameters for the default model were learned using naive bayes on the spatial distances. The default model was trained on 4128 manually annotated match pairs.

Returns:

the default DistanceCheck

compare

public double compare(DoGSIFTFeature query,
                      DoGSIFTFeature target)

Description copied from interface: DistanceComparator

Compare two objects, returning a score or distance.

Specified by:

compare in interface DistanceComparator<DoGSIFTFeature>

Parameters:

query - the first object

target - the second object

Returns:

a score or distance

isDistance

public boolean isDistance()

Specified by:

isDistance in interface DistanceComparator<DoGSIFTFeature>

Returns:

true if the comparison is a distance; false if similarity.