K-Means Clustering for Table Fields

Author(s)	O. Conrad (c) 2010
Library ID	table_tools
Tool ID	28
Version	1.0
Menu	Table \| Classification Shapes \| Attributes

Description

K-Means cluster analysis using selected features from attributes table.

References

Forgy, E. (1965): Cluster Analysis of multivariate data: efficiency vs. interpretability of classifications. Biometrics 21:768.

Rubin, J. (1967): Optimal Classification into Groups: An Approach for Solving the Taxonomy Problem. J. Theoretical Biology, 15:103-144.

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Table	table, input	`INPUT`	-	-
Output	Statistics	table, output	`STATISTICS`	-	-
	Result	table, output, optional	`RESULT_TABLE`	-	-
	Result	shapes, output, optional	`RESULT_SHAPES`	-	-
	Elbow Statistics	table, output	`ELBOW_STATS`	-	-
Options	Features	table fields	`FIELDS`	-	-
	Normalize	boolean	`NORMALISE`	-	Default: 0
	Cluster	table field	`CLUSTER`	Target field for cluster numbers. If not set a new field will be added	-
	Method	choice	`METHOD`	-	Available Choices: [0] Minimum Distance (Forgy 1965) [1] Hill Climbing (Rubin 1967) [2] Minimum Distance + Hill Climbing Default: 1
	Number of Clusters	integer number	`NCLUSTER`	-	Minimum: 2 Default: 10
	Maximum Iterations	integer number	`MAXITER`	Maximum number of iterations, ignored if zero.	Minimum: 0 Default: 0
	Start Partition	choice	`INITIALIZE`	-	Available Choices: [0] random [1] periodical [2] keep values Default: 0
	Start Partition	choice	`ELBOW_INIT`	-	Available Choices: [0] random [1] periodical Default: 0
	Elbow Method	choice	`ELBOW`	-	Available Choices: [0] no [1] absolute [2] change [3] maximum distance Default: 0
	Threshold Percentage	floating point number	`ELBOW_ABS`	-	Minimum: 0.000000 Maximum: 50.000000 Default: 10.000000
	Threshold Percentage	floating point number	`ELBOW_CHG`	-	Minimum: 0.000000 Maximum: 50.000000 Default: 5.000000

Command Line


Usage: saga_cmd table_tools 28 [-INPUT ] [-FIELDS ] [-NORMALISE ] [-CLUSTER ] [-STATISTICS ] [-RESULT_TABLE ] [-RESULT_SHAPES ] [-METHOD ] [-NCLUSTER ] [-MAXITER ] [-INITIALIZE ] [-ELBOW_INIT ] [-ELBOW ] [-ELBOW_ABS ] [-ELBOW_CHG ] [-ELBOW_STATS ]
  -INPUT:           Table
	table, input
  -FIELDS:          Features
	table fields
  -NORMALISE:       Normalize
	boolean
	Default: 0
  -CLUSTER:         Cluster
	table field
  -STATISTICS:      Statistics
	table, output
  -RESULT_TABLE:    Result
	table, output, optional
  -RESULT_SHAPES:   Result
	shapes, output, optional
  -METHOD:
                         Method
                         	choice
                         	Available Choices:
                         	[0] Minimum Distance (Forgy 1965)
                         	[1] Hill Climbing (Rubin 1967)
                         	[2] Minimum Distance + Hill Climbing
                         	Default: 1
  -NCLUSTER:        Number of Clusters
	integer number
	Minimum: 2
	Default: 10
  -MAXITER:         Maximum Iterations
	integer number
	Minimum: 0
	Default: 0
  -INITIALIZE:      Start Partition
	choice
	Available Choices:
	[0] random
	[1] periodical
	[2] keep values
	Default: 0
  -ELBOW_INIT:      Start Partition
	choice
	Available Choices:
	[0] random
	[1] periodical
	Default: 0
  -ELBOW:           Elbow Method
	choice
	Available Choices:
	[0] no
	[1] absolute
	[2] change
	[3] maximum distance
	Default: 0
  -ELBOW_ABS:    Threshold Percentage
	floating point number
	Minimum: 0.000000
	Maximum: 50.000000
	Default: 10.000000
  -ELBOW_CHG:    Threshold Percentage
	floating point number
	Minimum: 0.000000
	Maximum: 50.000000
	Default: 5.000000
  -ELBOW_STATS:     Elbow Statistics
	table, output