org.openimaj.image.model

Class FisherImages

java.lang.Object

org.openimaj.image.model.FisherImages

All Implemented Interfaces:

FeatureExtractor<DoubleFV,org.openimaj.image.FImage>, org.openimaj.io.ReadableBinary, org.openimaj.io.ReadWriteableBinary, org.openimaj.io.WriteableBinary, BatchTrainer<org.openimaj.util.pair.IndependentPair<?,org.openimaj.image.FImage>>

@Reference(type=Article,
           author={"Belhumeur, Peter N.","Hespanha, Jo\\~{a}o P.","Kriegman, David J."},
           title="Eigenfaces vs. Fisherfaces: Recognition Using Class Specific Linear Projection",
           year="1997",
           journal="IEEE Trans. Pattern Anal. Mach. Intell.",
           pages={"711","","720"},
           url="http://dx.doi.org/10.1109/34.598228",
           month="July",
           number="7",
           publisher="IEEE Computer Society",
           volume="19",
           customData={"issn","0162-8828","numpages","10","doi","10.1109/34.598228","acmid","261512","address","Washington, DC, USA","keywords","Appearance-based vision, face recognition, illumination invariance, Fisher\'s linear discriminant."})
public class FisherImages
extends Object
implements BatchTrainer<org.openimaj.util.pair.IndependentPair<?,org.openimaj.image.FImage>>, FeatureExtractor<DoubleFV,org.openimaj.image.FImage>, org.openimaj.io.ReadWriteableBinary

Implementation of Fisher Images (aka "FisherFaces"). PCA is used to avoid the singular within-class scatter matrix.

Author:

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

Constructor Summary

Constructors

Constructor and Description
FisherImages(int numComponents) Construct with the given number of components.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader()
DoubleFV	extractFeature(org.openimaj.image.FImage object)
double[]	getBasisVector(int index) Get a specific basis vector as a double array.
void	readBinary(DataInput in)
<KEY> void	train(org.openimaj.data.dataset.GroupedDataset<KEY,? extends org.openimaj.data.dataset.ListDataset<org.openimaj.image.FImage>,org.openimaj.image.FImage> data) Train on a grouped dataset.
void	train(List<? extends org.openimaj.util.pair.IndependentPair<?,org.openimaj.image.FImage>> data)
void	train(Map<?,? extends List<org.openimaj.image.FImage>> data) Train on a map of data.
org.openimaj.image.FImage	visualise(int num) Draw an eigenvector as an image
void	writeBinary(DataOutput out)

Methods inherited from class java.lang.Object

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

Constructor Detail

FisherImages

public FisherImages(int numComponents)

Construct with the given number of components.

Parameters:

numComponents - the number of components

Method Detail

readBinary

public void readBinary(DataInput in)
                throws IOException

Specified by:

readBinary in interface org.openimaj.io.ReadableBinary

Throws:

IOException

binaryHeader

public byte[] binaryHeader()

Specified by:

binaryHeader in interface org.openimaj.io.ReadableBinary

Specified by:

binaryHeader in interface org.openimaj.io.WriteableBinary

writeBinary

public void writeBinary(DataOutput out)
                 throws IOException

Specified by:

writeBinary in interface org.openimaj.io.WriteableBinary

Throws:

IOException

train

public void train(Map<?,? extends List<org.openimaj.image.FImage>> data)

Train on a map of data.

Parameters:

data - the data

train

public <KEY> void train(org.openimaj.data.dataset.GroupedDataset<KEY,? extends org.openimaj.data.dataset.ListDataset<org.openimaj.image.FImage>,org.openimaj.image.FImage> data)

Train on a grouped dataset.

Type Parameters:

KEY - The group type

Parameters:

data - the data

train

public void train(List<? extends org.openimaj.util.pair.IndependentPair<?,org.openimaj.image.FImage>> data)

Specified by:

train in interface BatchTrainer<org.openimaj.util.pair.IndependentPair<?,org.openimaj.image.FImage>>

extractFeature

public DoubleFV extractFeature(org.openimaj.image.FImage object)

Specified by:

extractFeature in interface FeatureExtractor<DoubleFV,org.openimaj.image.FImage>

getBasisVector

public double[] getBasisVector(int index)

Get a specific basis vector as a double array. The returned array contains a copy of the data.

Parameters:

index - the index of the vector

Returns:

the eigenvector

visualise

public org.openimaj.image.FImage visualise(int num)

Draw an eigenvector as an image

Parameters:

num - the index of the eigenvector to draw.

Returns:

an image showing the eigenvector.