de.lmu.ifi.dbs.jfeaturelib.features

Class LocalBinaryPatterns

java.lang.Object

de.lmu.ifi.dbs.jfeaturelib.features.AbstractFeatureDescriptor

de.lmu.ifi.dbs.jfeaturelib.features.LocalBinaryPatterns

All Implemented Interfaces:

Descriptor, FeatureDescriptor

public class LocalBinaryPatterns
extends AbstractFeatureDescriptor

Constructs a histogram of local binary patterns (LBP) for each pixel.

For each pixel a histogram of LBP is constructed from all pixels in the region specified by setNeighborhoodSize(int). In this region the LBP is calculated for every pixel. The LBP is calculated by comparing the pixel intensities of the central pixel to N neighboring pixels (setNumPoints(int)) on a circle of radius r (setRadius(double)). Interpolation is used to retrieve the intensity of neighboring pixels.

The first two features represent the x and y coordinates of the pixel, the remaining features the histogram of local binary patterns (see setNumberOfHistogramBins(int)).

In comparison to MeanIntensityLocalBinaryPatterns, this class computes one histogram of each pixel and computes local binary patterns from neighbors lying on a circle around the central pixel.

References:

Author:

sebp

See Also:

MeanIntensityLocalBinaryPatterns

Nested Class Summary

Nested classes/interfaces inherited from interface de.lmu.ifi.dbs.jfeaturelib.Descriptor

Descriptor.Supports

Field Summary

Fields

Modifier and Type	Field and Description
protected double	m_angle
protected ij.process.ImageProcessor	m_ip
protected double[]	m_offsets

Fields inherited from class de.lmu.ifi.dbs.jfeaturelib.features.AbstractFeatureDescriptor

pcs

Fields inherited from interface de.lmu.ifi.dbs.jfeaturelib.Descriptor

DOES_ALL

Constructor Summary

Constructors

Constructor and Description
LocalBinaryPatterns()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	calculateOffsets() Calculates relative offsets in x and y direction of neighors with respect to central pixel.
protected int	getBinaryPattern(int x, int y)
double	getConstant()
String	getDescription() Returns a short plain Text description about the Descriptor and the semantics of the double array obtained from FeatureDescriptor.getFeatures().
protected int	getMaxBinaryPattern()
int	getNumberOfHistogramBins()
int	getNumPoints()
double	getRadius()
protected double[]	processPixel(int x, int y)
void	run(ij.process.ImageProcessor ip) Start processing of this algorithm on the given image processor.
void	setConstant(double offset) Constant added to the intensity of the central pixel when comparing it to its neighbors.
protected void	setImageProcessor(ij.process.ImageProcessor ip)
void	setNeighborhoodSize(int neighborhoodSize) Set the size of the neighborhood that is considered to construct a histogram of binary patterns for each pixel.
void	setNumberOfHistogramBins(int numBins) Set the number of bins of the LBP histogram of each pixel.
void	setNumPoints(int numPoints) Number of neighbors to consider.
void	setProperties(LibProperties properties) Injects the properties class that can be used to retrieve several properties.
void	setRadius(double radius) Set the radius of the neighborhood to consider.
EnumSet<Descriptor.Supports>	supports() Determine the capabilities of this algorithm.

Methods inherited from class de.lmu.ifi.dbs.jfeaturelib.features.AbstractFeatureDescriptor

addData, addData, addData, addPropertyChangeListener, endProgress, firePropertyChange, getFeatures, getMask, inMask, setMask, startProgress

Methods inherited from class java.lang.Object

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

Field Detail

m_angle

protected double m_angle

m_offsets

protected double[] m_offsets

m_ip

protected ij.process.ImageProcessor m_ip

Constructor Detail

LocalBinaryPatterns

public LocalBinaryPatterns()

Method Detail

getDescription

public String getDescription()

Description copied from interface: FeatureDescriptor

Returns a short plain Text description about the Descriptor and the semantics of the double array obtained from FeatureDescriptor.getFeatures(). May return null if no description is implemented - even though this should be avoided by any means.

Returns:

semantic description of getFeatures or null.

supports

public EnumSet<Descriptor.Supports> supports()

Description copied from interface: Descriptor

Determine the capabilities of this algorithm.

Specified by:

supports in interface Descriptor

Overrides:

supports in class AbstractFeatureDescriptor

Returns:

the set of supported capabilities.

setProperties

public void setProperties(LibProperties properties)
                   throws IOException

Description copied from interface: FeatureDescriptor

Injects the properties class that can be used to retrieve several properties.

Specified by:

setProperties in interface FeatureDescriptor

Overrides:

setProperties in class AbstractFeatureDescriptor

Throws:

IOException - if something went wrong

run

public void run(ij.process.ImageProcessor ip)

Description copied from interface: Descriptor

Start processing of this algorithm on the given image processor. Keep in mind that if the imageProcessor is changed, Supports.NoChanges must not be set. This is also the case even if only ImageProcessor.snapshot() is used.

getMaxBinaryPattern

protected int getMaxBinaryPattern()

setImageProcessor

protected void setImageProcessor(ij.process.ImageProcessor ip)

calculateOffsets

protected void calculateOffsets()

Calculates relative offsets in x and y direction of neighors with respect to central pixel.

processPixel

protected double[] processPixel(int x,
                    int y)

getBinaryPattern

protected int getBinaryPattern(int x,
                   int y)

setNumPoints

public void setNumPoints(int numPoints)

Number of neighbors to consider.

All neighbors lie equally spaced on a circle determined by setRadius(double).

Parameters:

numPoints -

setRadius

public void setRadius(double radius)

Set the radius of the neighborhood to consider.

Parameters:

radius - in pixels

Throws:

IllegalArgumentException - if radius <= 0

setNeighborhoodSize

public void setNeighborhoodSize(int neighborhoodSize)

Set the size of the neighborhood that is considered to construct a histogram of binary patterns for each pixel.

For instance, a neighborhood size of 1 considers the 8-neighborhood of each pixel, and a neighborhood size of 2 the 25-neighborhood. The neighborhood is always quadractic.

Parameters:

neighborhoodSize - positive number

setConstant

public void setConstant(double offset)

Constant added to the intensity of the central pixel when comparing it to its neighbors.

setNumberOfHistogramBins

public void setNumberOfHistogramBins(int numBins)

Set the number of bins of the LBP histogram of each pixel.

Parameters:

numBins - a positive number

getRadius

public double getRadius()

getNumPoints

public int getNumPoints()

getConstant

public double getConstant()

getNumberOfHistogramBins

public int getNumberOfHistogramBins()