TPI Based Landform Classification

Author(s)	O.Conrad (c) 2011
Library ID	ta_morphometry
Tool ID	19
Version	1.0
Menu	Terrain Analysis \| Terrain Classification

Description

Topographic Position Index (TPI) calculation as proposed by Guisan et al. (1999). This is literally the same as the difference to the mean calculation (residual analysis) proposed by Wilson & Gallant (2000). The bandwidth parameter for distance weighting is given as percentage of the (outer) radius.

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Elevation	grid, input	`DEM`	-	-
Output	Landforms	grid, output	`LANDFORMS`	-	-
Output	Classes	table, output, optional	`CLASSES`	-	-
Options	Small Scale	value range	`RADIUS_A`	kernel radius; defines an annulus if minimum is greater than zero	Default: 0; 100
	Large Scale	value range	`RADIUS_B`	kernel radius; defines an annulus if minimum is greater than zero	Default: 0; 1000
	Radius Unit	choice	`UNIT`	-	Available Choices: [0] map units [1] cells Default: 0
	Weighting Function	choice	`DW_WEIGHTING`	-	Available Choices: [0] no distance weighting [1] inverse distance to a power [2] exponential [3] gaussian Default: 0
	Power	floating point number	`DW_IDW_POWER`	-	Minimum: 0.000000 Default: 2
	Bandwidth	floating point number	`DW_BANDWIDTH`	Bandwidth for exponential and Gaussian weighting	Minimum: 0.000000 Default: 75

Command Line


Usage: saga_cmd ta_morphometry 19 [-DEM ] [-LANDFORMS ] [-CLASSES ] [-RADIUS_A_MIN ] [-RADIUS_A_MAX ] [-RADIUS_B_MIN ] [-RADIUS_B_MAX ] [-UNIT ] [-DW_WEIGHTING ] [-DW_IDW_POWER ] [-DW_BANDWIDTH ]
  -DEM:               Elevation
	grid, input
  -LANDFORMS:         Landforms
	grid, output
  -CLASSES:           Classes
	table, output, optional
  -RADIUS_A_MIN:   Small Scale
	value range
	Default: 0; 100
  -RADIUS_A_MAX:   Small Scale
	value range
	Default: 0; 100
  -RADIUS_B_MIN:   Large Scale
	value range
	Default: 0; 1000
  -RADIUS_B_MAX:   Large Scale
	value range
	Default: 0; 1000
  -UNIT:              Radius Unit
	choice
	Available Choices:
	[0] map units
	[1] cells
	Default: 0
  -DW_WEIGHTING:      Weighting Function
	choice
	Available Choices:
	[0] no distance weighting
	[1] inverse distance to a power
	[2] exponential
	[3] gaussian
	Default: 0
  -DW_IDW_POWER:   Power
	floating point number
	Minimum: 0.000000
	Default: 2
  -DW_BANDWIDTH:   Bandwidth
	floating point number
	Minimum: 0.000000
	Default: 75