org.openimaj.ml.clustering.kmeans

Class HierarchicalIntKMeans

java.lang.Object

org.openimaj.ml.clustering.kmeans.HierarchicalIntKMeans

All Implemented Interfaces:

Clusterer<int[][]>, SpatialClusterer<HierarchicalIntKMeansResult,int[]>

@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 HierarchicalIntKMeans
extends Object
implements SpatialClusterer<HierarchicalIntKMeansResult,int[]>

Hierarchical Integer K-Means clustering (HierarchicalIntKMeans) is a simple hierarchical version of IntKMeans. 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
HierarchicalIntKMeans(int M, int K, int depth) Construct a new HierarchicalIntKMeans with the given parameters.
HierarchicalIntKMeans(KMeansConfiguration<IntNearestNeighbours,int[]> config, int M, int K, int depth) Construct a new HierarchicalIntKMeans with the given parameters.

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

HierarchicalIntKMeans

public HierarchicalIntKMeans(KMeansConfiguration<IntNearestNeighbours,int[]> config,
                             int M,
                             int K,
                             int depth)

Construct a new HierarchicalIntKMeans with the given parameters.

Parameters:

config - configuration for the underlying kmeans clustering.

M - Data dimensionality.

K - Number of clusters per node.

depth - Tree depth.

HierarchicalIntKMeans

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

Construct a new HierarchicalIntKMeans 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 HierarchicalIntKMeansResult cluster(int[][] data)

Description copied from interface: SpatialClusterer

Perform clustering on the given data.

Specified by:

cluster in interface SpatialClusterer<HierarchicalIntKMeansResult,int[]>

Parameters:

data - the data.

Returns:

the generated clusters.

performClustering

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

Specified by:

performClustering in interface Clusterer<int[][]>

Returns:

Given data items, cluster them by index

cluster

public HierarchicalIntKMeansResult cluster(DataSource<int[]> 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<HierarchicalIntKMeansResult,int[]>

Parameters:

data - the data.

Returns:

the generated clusters.