org.openimaj.image.model

Class EigenImages

java.lang.Object

org.openimaj.image.model.EigenImages

All Implemented Interfaces:

FeatureExtractor<DoubleFV,org.openimaj.image.FImage>, org.openimaj.io.ReadableBinary, org.openimaj.io.ReadWriteableBinary, org.openimaj.io.WriteableBinary, BatchTrainer<org.openimaj.image.FImage>

@Reference(type=Inproceedings,
           author={"Turk, M.A.","Pentland, A.P."},
           title="Face recognition using eigenfaces",
           year="1991",
           booktitle="Computer Vision and Pattern Recognition, 1991. Proceedings CVPR \'91., IEEE Computer Society Conference on",
           pages={"586 ","591"},
           month="jun",
           number="",
           volume="",
           customData={"keywords","eigenfaces;eigenvectors;face images;face recognition system;face space;feature space;human faces;two-dimensional recognition;unsupervised learning;computerised pattern recognition;eigenvalues and eigenfunctions;","doi","10.1109/CVPR.1991.139758"})
public class EigenImages
extends Object
implements BatchTrainer<org.openimaj.image.FImage>, FeatureExtractor<DoubleFV,org.openimaj.image.FImage>, org.openimaj.io.ReadWriteableBinary

Implementation of EigenImages. Can be used for things like face recognition ala the classic EigenFaces algorithm.

Fundamentally, the EigenImages technique is a way to perform dimensionality reduction on an image using PCA. This implementation can be trained through the BatchTrainer interface (which will internally normalise the data and perform PCA). Once trained, instances can be used as FeatureExtractors to extract low(er) dimensional features from images.

Methods are also provided to reconstruct an image from its feature vector (see and #reconstruct(double[]), and to visualise a specific principal component as an image (see visualisePC(int).

Author:

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

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EigenImages() For serialisation
	EigenImages(int numComponents) Construct with the given number of principal components.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader()
DoubleFV	extractFeature(org.openimaj.image.FImage img)
int	getNumComponents() Get the number of PCA components selected by this EigenImages object.
void	readBinary(DataInput in)
org.openimaj.image.FImage	reconstruct(double[] weights) Reconstruct an image from a weight vector
org.openimaj.image.FImage	reconstruct(DoubleFV weights) Reconstruct an image from a weight vector
String	toString()
void	train(List<? extends org.openimaj.image.FImage> data)
org.openimaj.image.FImage	visualisePC(int pc) Draw a principal component as an image.
void	writeBinary(DataOutput out)

Methods inherited from class java.lang.Object

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

Constructor Detail

EigenImages

protected EigenImages()

For serialisation

EigenImages

public EigenImages(int numComponents)

Construct with the given number of principal components.

Parameters:

numComponents - the number of PCs

Method Detail

extractFeature

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

Specified by:

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

train

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

Specified by:

train in interface BatchTrainer<org.openimaj.image.FImage>

reconstruct

public org.openimaj.image.FImage reconstruct(DoubleFV weights)

Reconstruct an image from a weight vector

Parameters:

weights - the weight vector

Returns:

the reconstructed image

reconstruct

public org.openimaj.image.FImage reconstruct(double[] weights)

Reconstruct an image from a weight vector

Parameters:

weights - the weight vector

Returns:

the reconstructed image

visualisePC

public org.openimaj.image.FImage visualisePC(int pc)

Draw a principal component as an image. The image will be normalised so it can be displayed correctly.

Parameters:

pc - the index of the PC to draw.

Returns:

an image showing the PC.

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

toString

public String toString()

Overrides:

toString in class Object

getNumComponents

public int getNumComponents()

Get the number of PCA components selected by this EigenImages object.

Returns:

the number of PCA components.