You are here: Start » AVL.NET » AVL.KMeansClustering Method

AVL.KMeansClustering Method

Clusters data using KMeans algorithm

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void KMeansClustering(
	AvlNet.Matrix inData,
	int inClusters,
	int inMaxIterations,
	int inSeed,
	float inTerminationFactor,
	AvlNet.KMeansClusteringMethod inClusteringMethod,
	out AvlNet.Matrix outCentroids,
	out int[] outPointToClusterAssignment,
	out float outDistanceSum
)

Parameters

Name Type Range Default Description
inDataAvlNet.MatrixData set, where variables are in columns and examples are in rows.
inClustersint<2, +INF>2Number of clusters to extract. Default value: 2.
inMaxIterationsint<10, 1000>200Maximal number of procedure iterations. Default value: 200.
inSeedint<0, INF>5489Seed to init random engine. Default value: 5489.
inTerminationFactorfloat<1.0f, 2.0f>1.5fAdditional factor of procedure stop. Default value: 1.5f.
inClusteringMethodAvlNet.KMeansClusteringMethodKMeansPlusPlusKMeans variant to use. Default value: KMeansPlusPlus.
outCentroidsAvlNet.MatrixResulting centroid points in feature space.
outPointToClusterAssignmentintArray of input point assignments to generated clusters.
outDistanceSumfloatSum of squared distances from points to its respective cluster centroids.

Errors

Error type Description
DomainError Empty dataset on input in KMeansClustering.
DomainError Cannot make more clusters than there is data in input dataset.

See also