org.openimaj.ml.clustering.kmeans

Class HierarchicalByteKMeans

java.lang.Object

org.openimaj.ml.clustering.kmeans.HierarchicalByteKMeans

All Implemented Interfaces:

Clusterer<byte[][]>, SpatialClusterer<HierarchicalByteKMeansResult,byte[]>

@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 HierarchicalByteKMeans
extends Object
implements SpatialClusterer<HierarchicalByteKMeansResult,byte[]>

Hierarchical Byte K-Means clustering (HierarchicalByteKMeans) is a simple hierarchical version of ByteKMeans. 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
HierarchicalByteKMeans(int M, int K, int depth) Construct a new HierarchicalByteKMeans with the given parameters.
HierarchicalByteKMeans(KMeansConfiguration<ByteNearestNeighbours,byte[]> config, int M, int K, int depth) Construct a new HierarchicalByteKMeans with the given parameters.

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

HierarchicalByteKMeans

public HierarchicalByteKMeans(KMeansConfiguration<ByteNearestNeighbours,byte[]> config,
                              int M,
                              int K,
                              int depth)

Construct a new HierarchicalByteKMeans with the given parameters.

Parameters:

config - configuration for the underlying kmeans clustering.

M - Data dimensionality.

K - Number of clusters per node.

depth - Tree depth.

HierarchicalByteKMeans

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

Construct a new HierarchicalByteKMeans 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 HierarchicalByteKMeansResult cluster(byte[][] data)

Description copied from interface: SpatialClusterer

Perform clustering on the given data.

Specified by:

cluster in interface SpatialClusterer<HierarchicalByteKMeansResult,byte[]>

Parameters:

data - the data.

Returns:

the generated clusters.

performClustering

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

Specified by:

performClustering in interface Clusterer<byte[][]>

Returns:

Given data items, cluster them by index

cluster

public HierarchicalByteKMeansResult cluster(DataSource<byte[]> 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<HierarchicalByteKMeansResult,byte[]>

Parameters:

data - the data.

Returns:

the generated clusters.