de.lmu.ifi.dbs.jfeaturelib.features

Class MeanPatchIntensityHistogram

java.lang.Object

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

de.lmu.ifi.dbs.jfeaturelib.features.MeanPatchIntensityHistogram

All Implemented Interfaces:

Descriptor, FeatureDescriptor

public class MeanPatchIntensityHistogram
extends AbstractFeatureDescriptor

This descriptor calculates a histogram of mean intensities of specified neighborhood size.

For each pixel in the image, a patch of size 1 + 2 * size is extracted, where size is determined by setSize(int). Mean intensities of all patches are summarized in a histogram.

Mean intensities are computed efficiently by using IntegralImage.

Author:

sebp

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 int	m_bins
protected double	m_histMax
protected double	m_histMin
protected IntegralImage	m_integralImage
protected int	m_patchArea
protected int	m_patchSize
protected int	m_size

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
MeanPatchIntensityHistogram()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	createIntegralImage(ij.process.ByteProcessor ip)
String	getDescription() Returns a short plain Text description about the Descriptor and the semantics of the double array obtained from FeatureDescriptor.getFeatures().
double	getHistogramMax()
double	getHistogramMin()
protected float	getMeanIntensity(int x, int y)
int	getNumberOfBins()
int	getSize()
protected void	retrieveMinAndMaxFromImage(ij.process.ImageProcessor ip)
void	run(ij.process.ImageProcessor ip) Start processing of this algorithm on the given image processor.
void	setHistogramRange(double min, double max) Set the minimum and maximum value that the histogram should consider.
void	setNumberOfBins(int bins) Set the number of bins of the histogram.
void	setProperties(LibProperties properties) Injects the properties class that can be used to retrieve several properties.
void	setSize(int size) Set size of neighborhood which determines the patch size.
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_size

protected int m_size

m_bins

protected int m_bins

m_histMin

protected double m_histMin

m_histMax

protected double m_histMax

m_patchSize

protected int m_patchSize

m_patchArea

protected int m_patchArea

m_integralImage

protected IntegralImage m_integralImage

Constructor Detail

MeanPatchIntensityHistogram

public MeanPatchIntensityHistogram()

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.

createIntegralImage

protected void createIntegralImage(ij.process.ByteProcessor ip)

retrieveMinAndMaxFromImage

protected void retrieveMinAndMaxFromImage(ij.process.ImageProcessor ip)

getMeanIntensity

protected float getMeanIntensity(int x,
                     int y)

getSize

public int getSize()

setSize

public void setSize(int size)

Set size of neighborhood which determines the patch size.

The outer most size pixels will not be considered because they have incomplete neighborhoods.

Parameters:

size -

Throws:

IllegalArgumentException - if size <= 0

getNumberOfBins

public int getNumberOfBins()

setNumberOfBins

public void setNumberOfBins(int bins)

Set the number of bins of the histogram.

Parameters:

bins -

Throws:

IllegalArgumentException - if bins <= 0

getHistogramMin

public double getHistogramMin()

getHistogramMax

public double getHistogramMax()

setHistogramRange

public void setHistogramRange(double min,
                     double max)

Set the minimum and maximum value that the histogram should consider.

If both min and max are set to zero (default), limits are retrieved from data.

Parameters:

min -

max -

Throws:

IllegalArgumentException - if min > max