TeeChart Pro includes classes and components to perform “clustering” on your data, and optionally visualize the results using a chart “Tool” component.
Clustering is the process of grouping data automatically, according to how well related are the individual items.
As an unsupervised algorithm, its widely used in data-mining / machine-learning / B.I. (Business Intelligence) applications.
For more information on clustering visit the following Wikipedia link: http://en.wikipedia.org/wiki/Cluster_analysis
An executable example:
The clustering algorithm can be processed on custom data, not necessarily on TeeChart “Series” data.
Classes and Units
The TeeClustering.pas unit, for both VCL and Firemonkey, contains abstract “engine” classes that perform the clustering algorithms.
Three different clustering methods are provided:
• TQTClustering (Quality Threshold)
These classes derive from a common abstract class: TBaseClustering.
Each clustering method has its own properties that determine how will the clusters be calculated. After calculating, you can access the Clusters property, which is a TList of TCluster objects.
A TCluster contains child clusters (Items[ ]), so you can check which input data items belong to which cluster, or in the case of the Hierarchical type, access the tree structure (clusters and sub-clusters).
The input data (your data) is not contained by the above classes.
Data is passed to the clustering engine through a “provider” class. There is currently one kind of data provider (TSeriesProvider) to cluster XY or XYZ Series points.
This class is implemented in the TeeClusteringTool.pas unit, together with a charting Tool class (TClusteringTool) to make things easier and more automatic.
Example runtime code (it can be done at design-time too, without coding) :
var tool : TClusteringTool;
tool.Series:=Series1; // your series
After execution, you can loop on the resulting output clusters, for example:
var t : Integer;
for t:=0 to tool.Clusters.Count-1 do
Memo1.Lines.Add( ‘Cluster: ‘+IntToStr(t)+’ contains: ‘+
IntToStr(tool.Clusters[t].Count)+’ points’ );
This tool automatically performs clustering using the choosen method and parameters, and optionally paints each source series point with a different color indicating which cluster they belong to, and/or draws polygons around each group of cluster’s items, among other things.
ClusteringTool1.Method := cmHierarchical;
ClusteringTool1.ColorEach := True; // paint Series with one color per cluster
ClusteringTool1.ShowBounds := True; // draws convex polygons bounding each cluster points
ClusteringTool1.Centers.Visible := True; // shows cluster centers
ClusteringTool1.Centroids.Visible := True; // shows cluster centroids
Other properties include Brush, Pen and Transparency, used when drawing cluster polygon boundaries.
Several helper methods are provided:
// Obtain cluster’s center and centroid XY points in Series scales:
var P : TPointFloat;
P:=ClusteringTool1.GetClusterCenter( ClusteringTool1.Clusters );
P:=ClusteringTool1.GetClusterCentroid( ClusteringTool1.Clusters );
// Obtain an array of XY points (in screen pixel coordinates), that belong to cluster:
var PP : TPointArray;
ClusteringTool1.GetClusterPoints( ClusteringTool1.Clusters, PP);
// Get cluster statistics:
var S : TClusterStats;
S:=ClusteringTool1.GetStats( ClusteringTool1.Clusters );
Each clustering algorithm needs different parameters:
ClusteringTool1.KMeans.NumClusters := 10; // Number of minimum clusters (“K”)
ClusteringTool1.KMeans.MaxIterations := 1000; // Maximum number of iterations before stopping
ClusteringTool1.Hierarchical.NumClusters := 8; // Number of tree root clusters
ClusteringTool1.QTClustering.MinCount := 30; // Minimum number of points to form a cluster
ClusteringTool1.QTClustering.MaxDiameter := 100; // Maximum “diameter” a cluster can grow
Cluster calculation is based on the “distance” between a data item and the other data items. There are several ways to calculate the “distance” between items.
The algorithms are agnostic, they call the Provider (ie: Series provider) to obtain the distances.
For example, on a XY scatter plot, the distance between points can be for example the hypotenuse (Pythagoras’ theorem), that is, the simple Euclidean distance between a point XY and another XY.
Distance calculations implemented:
ClusteringTool1.Distance := dmMinkowski;
ClusteringTool1.MinkowskiLambda := 4;
There are several ways to calculate the “distance” between clusters when one or the two clusters have more than one item.
This is called “linkage”.
The most simple way is using each cluster “center” (this means no linkage occurs).
Other linkage styles implemented:
Also called “minimum”.
The distance between cluster A and B is the minimum distance between all items in cluster A and all items in cluster B.
Also called “maximum”.
The distance between cluster A and B is the maximum distance between all items in cluster A and all items in cluster B.
The distance between cluster A and B is the average distance between all items in cluster A and all items in cluster B.
The result is the increase on “error sum of squares” when adding cluster B items to cluster A.
Clustering is a slow process by nature. Each clustering method has different performance bottlenecks, proportional to the number of input data items.
The TeeClustering.pas unit has been greatly fine-tuned to optimize the speed of each algorithm, although much work is needed to find more advanced techniques that require less CPU cycles.
The QT Threshold algorithm benefits of parallelism, when multiple CPUs can be used together.
Speed examples (revisited):
(Time in milliseconds, Windows 8.1 x64 on Intel i7 4770 @ 3.4Ghz)
IDE XE8 Delphi, Win32, 5000 data points
Algorithm Single CPU Multiple CPU
K-Means 47 31
Hierarchical 4328 4156
QT 2859 703
x64 bit executables are a little bit faster than 32bit.
Speed is also very dependant on the “distance” calculation method that is used to compare data. The default Euclidean calculation has a quite big CPU cost as it calculates the Hypotenuse between two data XY value pairs.