org.openimaj.image.processing.face.feature.ltp

Class AbstractLtpDtFeature

java.lang.Object

org.openimaj.image.processing.face.feature.ltp.AbstractLtpDtFeature

All Implemented Interfaces:

FacialFeature, ReadableBinary, ReadWriteableBinary, WriteableBinary

Direct Known Subclasses:

LtpDtFeature

@Reference(type=Article,
           author={"Tan, Xiaoyang","Triggs, Bill"},
           title="Enhanced local texture feature sets for face recognition under difficult lighting conditions",
           year="2010",
           journal="Trans. Img. Proc.",
           pages={"1635","1650"},
           url="http://dx.doi.org/10.1109/TIP.2010.2042645",
           month="June",
           number="6",
           publisher="IEEE Press",
           volume="19")
public class AbstractLtpDtFeature
extends Object
implements FacialFeature

Base class for LTP based features using a truncated Euclidean distance transform to estimate the distances within each slice.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
List<List<Pixel>>	ltpPixels The pixels forming the binary patterns in each slice

Constructor Summary

Constructors

Constructor and Description
AbstractLtpDtFeature(int width, int height, LTPWeighting weighting, List<List<Pixel>> ltpPixels) Construct with given parameters.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader() Header for binary input.
protected FImage[]	constructSlices(List<List<Pixel>> ltpPixels, int width, int height)
protected FImage[]	extractDistanceTransforms(FImage[] slices, LTPWeighting weighting)
protected static List<List<Pixel>>	extractLTPSlicePixels(FImage image)
FImage[]	getDistanceMaps() Get the Euclidean distance maps for each slice.
protected static FImage	normaliseImage(FImage image, FImage mask)
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

Field Detail

ltpPixels

public List<List<Pixel>> ltpPixels

The pixels forming the binary patterns in each slice

Constructor Detail

AbstractLtpDtFeature

public AbstractLtpDtFeature(int width,
                            int height,
                            LTPWeighting weighting,
                            List<List<Pixel>> ltpPixels)

Construct with given parameters.

Parameters:

width - the face patch width

height - the face patch height

weighting - the weighting scheme

ltpPixels - the pattern

Method Detail

getDistanceMaps

public FImage[] getDistanceMaps()

Get the Euclidean distance maps for each slice. The maps are cached internally and are generated on the first call to this method.

Returns:

the distance maps

normaliseImage

protected static FImage normaliseImage(FImage image,
                                       FImage mask)

extractLTPSlicePixels

protected static List<List<Pixel>> extractLTPSlicePixels(FImage image)

extractDistanceTransforms

protected FImage[] extractDistanceTransforms(FImage[] slices,
                                             LTPWeighting weighting)

constructSlices

protected FImage[] constructSlices(List<List<Pixel>> ltpPixels,
                                   int width,
                                   int height)

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