SAGA-GIS Tool Library Documentation (v6.1.0)

Tool K-Means Clustering for Grids

Cluster Analysis for grids.

References:

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

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

Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridsGrid list (input)GRIDS--
OutputClustersGrid (output)CLUSTER--
StatisticsTable (output)STATISTICS--
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
MethodChoiceMETHOD-Available Choices:
[0] Iterative Minimum Distance (Forgy 1965)
[1] Hill-Climbing (Rubin 1967)
[2] Combined Minimum Distance / Hillclimbing
Default: 1
ClustersIntegerNCLUSTERNumber of clustersMinimum: 2
Default: 10
Maximum IterationsIntegerMAXITERmaximum number of iterations, ignored if set to zero (default)Minimum: 0
Default: 0
NormaliseBooleanNORMALISEAutomatically normalise grids by standard deviation before clustering.Default: 0
Update Colors from FeaturesBooleanRGB_COLORSUse the first three features in list to obtain blue, green, red components for class colour in look-up table.Default: 1
Old VersionBooleanOLDVERSIONslower but memory savingDefault: 0
Update ViewBooleanUPDATEVIEW-Default: 1

Command-line

Usage: saga_cmd imagery_classification 1 [-GRIDS <str>] [-CLUSTER <str>] [-STATISTICS <str>] [-METHOD <str>] [-NCLUSTER <num>] [-MAXITER <num>] [-NORMALISE <str>] [-OLDVERSION <str>] [-UPDATEVIEW <str>]
  -GRIDS:<str>     	Grids
	Grid list (input)
  -CLUSTER:<str>   	Clusters
	Grid (output)
  -STATISTICS:<str>	Statistics
	Table (output)
  -METHOD:<str>    	Method
	Choice
	Available Choices:
	[0] Iterative Minimum Distance (Forgy 1965)
	[1] Hill-Climbing (Rubin 1967)
	[2] Combined Minimum Distance / Hillclimbing
	Default: 1
  -NCLUSTER:<num>  	Clusters
	Integer
	Minimum: 2
	Default: 10
  -MAXITER:<num>   	Maximum Iterations
	Integer
	Minimum: 0
	Default: 0
  -NORMALISE:<str> 	Normalise
	Boolean
	Default: 0
  -OLDVERSION:<str>	Old Version
	Boolean
	Default: 0
  -UPDATEVIEW:<str>	Update View
	Boolean
	Default: 1