org.openimaj.ml.clustering.kmeans

Class HierarchicalShortKMeans

java.lang.Object

org.openimaj.ml.clustering.kmeans.HierarchicalShortKMeans

All Implemented Interfaces:

Clusterer<short[][]>, SpatialClusterer<HierarchicalShortKMeansResult,short[]>

@Reference(type=Inproceedings,
           author={"David. Nist\'er","Henrik. Stew\'enius"},
           title="Scalable Recognition with a Vocabulary Tree",
           year="2006",
           booktitle="CVPR",
           pages={"2161","","2168"},
           customData={"Date-Added","2010-11-12 09:33:18 +0000","Date-Modified","2010-11-22 15:11:22 +0000"})
public class HierarchicalShortKMeans
extends Object
implements SpatialClusterer<HierarchicalShortKMeansResult,short[]>

Hierarchical Short K-Means clustering (HierarchicalShortKMeans) is a simple hierarchical version of ShortKMeans. The algorithm recursively applies

Author:

Sina Samangooei (ss@ecs.soton.ac.uk), Jonathon Hare (jsh2@ecs.soton.ac.uk)

Constructor Summary

Constructors

Constructor and Description
HierarchicalShortKMeans(int M, int K, int depth) Construct a new HierarchicalShortKMeans with the given parameters.
HierarchicalShortKMeans(KMeansConfiguration<ShortNearestNeighbours,short[]> config, int M, int K, int depth) Construct a new HierarchicalShortKMeans with the given parameters.

Method Summary

Modifier and Type	Method and Description
HierarchicalShortKMeansResult	cluster(DataSource<short[]> data) Perform clustering with data from a data source.
HierarchicalShortKMeansResult	cluster(short[][] data) Perform clustering on the given data.
int[][]	performClustering(short[][] data)

Methods inherited from class java.lang.Object

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

Constructor Detail

HierarchicalShortKMeans

public HierarchicalShortKMeans(KMeansConfiguration<ShortNearestNeighbours,short[]> config,
                               int M,
                               int K,
                               int depth)

Construct a new HierarchicalShortKMeans with the given parameters.

Parameters:

config - configuration for the underlying kmeans clustering.

M - Data dimensionality.

K - Number of clusters per node.

depth - Tree depth.

HierarchicalShortKMeans

public HierarchicalShortKMeans(int M,
                               int K,
                               int depth)

Construct a new HierarchicalShortKMeans with the given parameters. Uses the default parameters of the KMeansConfiguration.

Parameters:

M - Data dimensionality.

K - Number of clusters per node.

depth - Tree depth.

Method Detail

cluster

public HierarchicalShortKMeansResult cluster(short[][] data)

Description copied from interface: SpatialClusterer

Perform clustering on the given data.

Specified by:

cluster in interface SpatialClusterer<HierarchicalShortKMeansResult,short[]>

Parameters:

data - the data.

Returns:

the generated clusters.

performClustering

public int[][] performClustering(short[][] data)

Specified by:

performClustering in interface Clusterer<short[][]>

Returns:

Given data items, cluster them by index

cluster

public HierarchicalShortKMeansResult cluster(DataSource<short[]> data)

Description copied from interface: SpatialClusterer

Perform clustering with data from a data source. The DataSource could potentially be backed by disk rather in memory.

Specified by:

cluster in interface SpatialClusterer<HierarchicalShortKMeansResult,short[]>

Parameters:

data - the data.

Returns:

the generated clusters.