You are here: Start » Function Reference » Clustering » ClusterPoints3D

ClusterPoints3D

Clusters 3D points using K Means Clustering method.

Header:	AVL.h

Syntax

void avl::ClusterPoints3D
(
	const atl::Array<avl::Point3D>& inPoints,
	const int inClusters,
	const int inMaxIterations,
	atl::Array<atl::Conditional<atl::Array<avl::Point3D>>>& outClusters,
	atl::Array<atl::Conditional<avl::Point3D>>& outCentroids,
	float& outDistanceSum
)

void ClusterPoints3D
(
	Point3D[] inPoints,
	int inClusters,
	int inMaxIterations,
	out Point3D[][] outClusters,
	out Point3D?[] outCentroids,
	out float outDistanceSum
)

Parameters

Name	Type	Range	Default	Description
inPoints	const Array<Point3D>&			Array of points to cluster
inClusters	const int	2 - +	2	Number of clusters to extract
inMaxIterations	const int	10 - 1000	200	Maximal number of KMeans iterations
outClusters	Array<Conditional<Array<Point3D>>>&			Resulting Point3D clusters
outCentroids	Array<Conditional<Point3D>>&			Center of found clusters
outDistanceSum	float&			Sum of distance squares from points in array to its respective cluster center