org.openimaj.image.feature.dense.binarypattern

Class UniformBinaryPattern

java.lang.Object

org.openimaj.image.feature.dense.binarypattern.UniformBinaryPattern

@Reference(type=Article,
           author={"Ojala, T.","Pietikainen, M.","Maenpaa, T."},
           title="Multiresolution gray-scale and rotation invariant texture classification with local binary patterns",
           year="2002",
           journal="Pattern Analysis and Machine Intelligence, IEEE Transactions on",
           pages={"971 ","987"},
           month="jul",
           number="7",
           volume="24",
           customData={"doi","10.1109/TPAMI.2002.1017623","ISSN","0162-8828"})
public class UniformBinaryPattern
extends Object

Class for determining whether specific binary patterns are "uniform". Uniform patterns have less than one 01 transition and one 01 transition when viewed as a circular buffer.

The class caches lookup tables of uniform patterns on demand, with the exception of the commonly used 8-bit patterns which are cached on initialization.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected static gnu.trove.map.hash.TIntObjectHashMap<gnu.trove.list.array.TIntArrayList>	lut

Constructor Summary

Constructors

Constructor and Description
UniformBinaryPattern()

Method Summary

Modifier and Type	Method and Description
protected static gnu.trove.list.array.TIntArrayList	calculateUniformPatterns(int nbits)
static FImage	extractPatternImage(int[][] patternImage, int code) Compute a binary map showing the locations of the specified pattern code.
static FImage[]	extractPatternImages(int[][] patternImage, int nbits) Compute all binary maps for each possible pattern code given the number of bits used to encode patterns.
static boolean[][][]	extractPatternMaps(int[][] patternImage, int nbits) Compute all binary maps for each possible pattern code given the number of bits used to encode patterns.
static List<List<Pixel>>	extractPatternPixels(int[][] patternImage, int nbits) Compute all pixels matching each possible pattern code given the number of bits used to encode patterns.
static gnu.trove.list.array.TIntArrayList	getUniformPatterns(int nbits) Get a list of all the binary patterns of a given length that are "uniform".
static boolean	isPatternUniform(int pattern, int nbits) Check whether the given nbits pattern is uniform.
protected static boolean	isUniform(boolean[] pattern)

Methods inherited from class java.lang.Object

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

Field Detail

lut

protected static gnu.trove.map.hash.TIntObjectHashMap<gnu.trove.list.array.TIntArrayList> lut

Constructor Detail

UniformBinaryPattern

public UniformBinaryPattern()

Method Detail

calculateUniformPatterns

protected static gnu.trove.list.array.TIntArrayList calculateUniformPatterns(int nbits)

isUniform

protected static boolean isUniform(boolean[] pattern)

getUniformPatterns

public static gnu.trove.list.array.TIntArrayList getUniformPatterns(int nbits)

Get a list of all the binary patterns of a given length that are "uniform". Uniform patterns have less than one 01 transition and one 01 transition when viewed as a circular buffer. The length must be between 1 and 32 bits.

Parameters:

nbits - pattern length

Returns:

set of patterns encoded as integers

isPatternUniform

public static boolean isPatternUniform(int pattern,
                                       int nbits)

Check whether the given nbits pattern is uniform.

Parameters:

pattern - the pattern

nbits - the pattern length

Returns:

true if uniform; false otherwise.

extractPatternImage

public static FImage extractPatternImage(int[][] patternImage,
                                         int code)

Compute a binary map showing the locations of the specified pattern code.

Parameters:

patternImage - the pattern data

code - the code to extract

Returns:

a binary FImage depicting the locations of the given code

extractPatternImages

public static FImage[] extractPatternImages(int[][] patternImage,
                                            int nbits)

Compute all binary maps for each possible pattern code given the number of bits used to encode patterns.

Parameters:

patternImage - the pattern data

nbits - the number of bits for the patterns

Returns:

an array of binary maps corresponding to each pattern

extractPatternMaps

public static boolean[][][] extractPatternMaps(int[][] patternImage,
                                               int nbits)

Compute all binary maps for each possible pattern code given the number of bits used to encode patterns.

Parameters:

patternImage - the pattern data

nbits - the number of bits for the patterns

Returns:

an array of binary maps corresponding to each pattern

extractPatternPixels

public static List<List<Pixel>> extractPatternPixels(int[][] patternImage,
                                                     int nbits)

Compute all pixels matching each possible pattern code given the number of bits used to encode patterns.

Parameters:

patternImage - the pattern data

nbits - the number of bits for the patterns

Returns:

an array of binary maps corresponding to each pattern