org.openimaj.image.segmentation

Class KMColourSegmenter

java.lang.Object

org.openimaj.image.segmentation.KMColourSegmenter

All Implemented Interfaces:

Segmenter<MBFImage>

Direct Known Subclasses:

KMSpatialColourSegmenter

public class KMColourSegmenter
extends Object
implements Segmenter<MBFImage>

Simple image segmentation from grouping colours with k-means.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected ColourSpace	colourSpace
protected FloatKMeans	kmeans
protected float[]	scaling

Constructor Summary

Constructors

Constructor and Description
KMColourSegmenter(ColourSpace colourSpace, float[] scaling, int K, FloatFVComparator distance) Construct using the given colour space, number of segments, and distance measure.
KMColourSegmenter(ColourSpace colourSpace, float[] scaling, int K, FloatFVComparator distance, int maxIters) Construct using the given colour space, number of segments, and distance measure.
KMColourSegmenter(ColourSpace colourSpace, int K) Construct using the given colour space and number of segments.
KMColourSegmenter(ColourSpace colourSpace, int K, FloatFVComparator distance) Construct using the given colour space, number of segments, and distance measure.

Method Summary

Modifier and Type	Method and Description
protected float[][]	imageToVector(MBFImage image)
List<? extends PixelSet>	segment(MBFImage image) Segment an image into ConnectedComponents.

Methods inherited from class java.lang.Object

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

Field Detail

colourSpace

protected ColourSpace colourSpace

scaling

protected float[] scaling

kmeans

protected FloatKMeans kmeans

Constructor Detail

KMColourSegmenter

public KMColourSegmenter(ColourSpace colourSpace,
                         int K)

Construct using the given colour space and number of segments. Euclidean distance is used, and the elements of each colour band are unscaled. Up to 100 K-Means iterations will be performed.

Parameters:

colourSpace - the colour space

K - the number of segments

KMColourSegmenter

public KMColourSegmenter(ColourSpace colourSpace,
                         int K,
                         FloatFVComparator distance)

Construct using the given colour space, number of segments, and distance measure. The elements of each colour band are unscaled. Up to 100 K-Means iterations will be performed.

Parameters:

colourSpace - the colour space

K - the number of segments

distance - the distance measure

KMColourSegmenter

public KMColourSegmenter(ColourSpace colourSpace,
                         float[] scaling,
                         int K,
                         FloatFVComparator distance)

Construct using the given colour space, number of segments, and distance measure. The elements of each colour band are by the corresponding elements in the given scaling vector. Up to 100 K-Means iterations will be performed.

Parameters:

colourSpace - the colour space

scaling - the scaling vector

K - the number of segments

distance - the distance measure

KMColourSegmenter

public KMColourSegmenter(ColourSpace colourSpace,
                         float[] scaling,
                         int K,
                         FloatFVComparator distance,
                         int maxIters)

Construct using the given colour space, number of segments, and distance measure. The elements of each colour band are by the corresponding elements in the given scaling vector, and the k-means algorithm will iterate at most maxIters times.

Parameters:

colourSpace - the colour space

scaling - the scaling vector

K - the number of segments

distance - the distance measure

maxIters - the maximum number of iterations to perform

Method Detail

imageToVector

protected float[][] imageToVector(MBFImage image)

segment

public List<? extends PixelSet> segment(MBFImage image)

Description copied from interface: Segmenter

Segment an image into ConnectedComponents.

Specified by:

segment in interface Segmenter<MBFImage>

Parameters:

image - the to segment

Returns:

list of extracted ConnectedComponents.