SAGA-GIS Tool Library Documentation (v7.8.2)

Tool K-Means Clustering for Grids

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
ClustersIntegerNCLUSTERNumber of clustersMinimum: 2
Default: 10
Maximum IterationsIntegerMAXITERmaximum number of iterations, ignored if set to zero (default)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 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>] [-INITIALIZE <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: 10
  -NORMALISE:<str> 	Normalise
	Boolean
	Default: 0
  -INITIALIZE:<str>	Start Partition
	Choice
	Available Choices:
	[0] random
	[1] periodical
	[2] keep values
	Default: 0
  -OLDVERSION:<str>	Old Version
	Boolean
	Default: 0
  -UPDATEVIEW:<str>	Update View
	Boolean
	Default: 1