org.openimaj.image.feature.dense.binarypattern

Class LocalTernaryPattern

java.lang.Object

org.openimaj.image.feature.dense.binarypattern.LocalTernaryPattern

All Implemented Interfaces:

ImageAnalyser<FImage>

@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 LocalTernaryPattern
extends Object
implements ImageAnalyser<FImage>

Implementation of a Local Ternary Pattern.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected int[][]	negativeBinaryPattern
protected int[][]	positiveBinaryPattern
protected float	radius
protected int	samples
protected int[][]	ternaryPattern
protected float	threshold

Constructor Summary

Constructors

Constructor and Description
LocalTernaryPattern(float radius, int samples, float threshold) Construct an LTP extractor with the given parameters.

Method Summary

Modifier and Type	Method and Description
void	analyseImage(FImage image) Analyse an image.
static int[][][]	calculateLTP(FImage image, float radius, int samples, float threshold) Calculate the LBP for every pixel in the image.
static int[]	calculateLTP(FImage image, float radius, int samples, float threshold, int x, int y) Calculate the LTP for a single point.
static int[]	calculateLTP(FImage image, float radius, int samples, float threshold, Pixel point) Calculate the LTP for a single point.
int[][]	getNegativePattern() Get the negative pattern created during the last call to analyseImage(FImage).
int[][]	getPositivePattern() Get the positive pattern created during the last call to analyseImage(FImage).
int[][]	getTernaryPattern() Get the ternary pattern created during the last call to analyseImage(FImage).

Methods inherited from class java.lang.Object

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

Field Detail

positiveBinaryPattern

protected int[][] positiveBinaryPattern

negativeBinaryPattern

protected int[][] negativeBinaryPattern

ternaryPattern

protected int[][] ternaryPattern

radius

protected float radius

samples

protected int samples

threshold

protected float threshold

Constructor Detail

LocalTernaryPattern

public LocalTernaryPattern(float radius,
                           int samples,
                           float threshold)

Construct an LTP extractor with the given parameters.

Parameters:

radius - the radius of the sampling circle

samples - the number of samples around the circle

threshold - the threshold

Method Detail

calculateLTP

public static int[][][] calculateLTP(FImage image,
                                     float radius,
                                     int samples,
                                     float threshold)

Calculate the LBP for every pixel in the image. The returned array of LBP codes hase the same dimensions as the image. Samples taken from outside the image bounds are assumed to have the value 0.

Parameters:

image - the image

radius - the radius of the sampling circle

samples - the number of samples around the circle

threshold - the threshold

Returns:

three 2d-arrays of the positive and negative binary LTP codes and the ternary code for every pixel

calculateLTP

public static int[] calculateLTP(FImage image,
                                 float radius,
                                 int samples,
                                 float threshold,
                                 int x,
                                 int y)

Calculate the LTP for a single point. The point must be within the image.

Parameters:

image - the image

radius - the radius of the sampling circle

samples - the number of samples around the circle

threshold - the threshold

x - the x-coordinate of the point

y - the y-coordinate of the point

Returns:

the LTP code (positive and negative binary code and ternary code)

calculateLTP

public static int[] calculateLTP(FImage image,
                                 float radius,
                                 int samples,
                                 float threshold,
                                 Pixel point)

Calculate the LTP for a single point. The point must be within the image.

Parameters:

image - the image

radius - the radius of the sampling circle

threshold - the threshold

samples - the number of samples around the circle

point - the point

Returns:

the LTP code (positive and negative binary code and ternary code)

analyseImage

public void analyseImage(FImage image)

Description copied from interface: ImageAnalyser

Analyse an image.

Specified by:

analyseImage in interface ImageAnalyser<FImage>

Parameters:

image - The image to process in place.

getPositivePattern

public int[][] getPositivePattern()

Get the positive pattern created during the last call to analyseImage(FImage).

Returns:

the pattern

getNegativePattern

public int[][] getNegativePattern()

Get the negative pattern created during the last call to analyseImage(FImage).

Returns:

the pattern

getTernaryPattern

public int[][] getTernaryPattern()

Get the ternary pattern created during the last call to analyseImage(FImage).

Returns:

the pattern