de.lmu.ifi.dbs.jfeaturelib.features

Class ColorHistogram

java.lang.Object

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

de.lmu.ifi.dbs.jfeaturelib.features.ColorHistogram

All Implemented Interfaces:

Descriptor, FeatureDescriptor

public class ColorHistogram
extends AbstractFeatureDescriptor

A RGB/HSB histogram. This color space can be split sensibly in a non-uniform way, to give more detail e.g. to the hues, while not splitting fine on the saturation. In case of using the HSB color space, good results have been reported with 7x2x2 and 7x3x3 splits, for example. This code is contributed to jFeatureLib from the ELKI data mining project at http://elki.dbs.ifi.lmu.de/ Recommended distance functions for this feature:

• minkowski.ManhattanDistanceFunction, since the histograms are normalized
• colorhistogram.HistogramIntersectionDistanceFunction (equivalent to Manhattan on normalized histograms)
• colorhistogram.HSBHistogramQuadraticDistanceFunction

Since:

1.3.0

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ColorHistogram.TYPE Type defining which type of colorspace should be used

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

Descriptor.Supports

Field Summary

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
ColorHistogram() Constructor for 7x3x3 = 63 bins.
ColorHistogram(int quanth, int quants, int quantb)

Method Summary

Methods

Modifier and Type	Method and Description
String	getDescription() Returns a short plain Text description about the Descriptor and the semantics of the double array obtained from FeatureDescriptor.getFeatures().
void	run(ij.process.ImageProcessor ip) Start processing of this algorithm on the given image processor.
void	setProperties(LibProperties properties) Injects the properties class that can be used to retrieve several properties.
ColorHistogram	setType(ColorHistogram.TYPE type) set the type of extraction to either RGB or HSB
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

Constructor Detail

ColorHistogram

public ColorHistogram()

Constructor for 7x3x3 = 63 bins.

ColorHistogram

public ColorHistogram(int quanth,
              int quants,
              int quantb)

Parameters:

quanth - Bins in Hue/Red

quants - Bins in Saturation/Green

quantb - Bins in Brightness/Blue

Method Detail

setType

public ColorHistogram setType(ColorHistogram.TYPE type)

set the type of extraction to either RGB or HSB

Parameters:

type -

setProperties

public void setProperties(LibProperties properties)

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

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.

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.

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.