SAGA 9.3.3 | Tool Library Documentation

K-Means Clustering for Grids


Description

This tool implements the K-Means cluster analysis for grids in two variants, iterative minimum distance (Forgy 1965) and hill climbing (Rubin 1967).


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridsgrid list, inputGRIDS--
OutputClustersgrid, outputCLUSTER--
Statisticstable, outputSTATISTICS--
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
Clustersinteger numberNCLUSTERNumber of clustersMinimum: 2 Default: 10
Maximum Iterationsinteger numberMAXITERMaximum number of iterations, ignored if set to zero.Minimum: 0 Default: 10
NormalisebooleanNORMALISEAutomatically normalise grids by standard deviation before clustering.Default: 0
Update Colors from Featuresboolean, GUIRGB_COLORSUse the first three features in list to obtain blue, green, red components for class colour in look-up table.Default: 0
Start PartitionchoiceINITIALIZE-Available Choices: [0] random [1] periodical [2] keep values Default: 0
Old VersionbooleanOLDVERSIONslower but memory savingDefault: 0
Update Viewboolean, GUIUPDATEVIEW-Default: 1

Command Line


Usage: saga_cmd imagery_classification 1 [-GRIDS ] [-CLUSTER ] [-STATISTICS ] [-METHOD ] [-NCLUSTER ] [-MAXITER ] [-NORMALISE ] [-INITIALIZE ] [-OLDVERSION ]
  -GRIDS:     	Grids
	grid list, input
  -CLUSTER:   	Clusters
	grid, output
  -STATISTICS:	Statistics
	table, output
  -METHOD:    	Method
	choice
	Available Choices:
	[0] Iterative Minimum Distance (Forgy 1965)
	[1] Hill-Climbing (Rubin 1967)
	[2] Combined Minimum Distance / Hillclimbing
	Default: 1
  -NCLUSTER:  	Clusters
	integer number
	Minimum: 2
	Default: 10
  -MAXITER:   	Maximum Iterations
	integer number
	Minimum: 0
	Default: 10
  -NORMALISE: 	Normalise
	boolean
	Default: 0
  -INITIALIZE:	Start Partition
	choice
	Available Choices:
	[0] random
	[1] periodical
	[2] keep values
	Default: 0
  -OLDVERSION:	Old Version
	boolean
	Default: 0