SAGA 9.4.2 | Tool Library Documentation

Multi-Scale Topographic Position Index (TPI)


Description

Topographic Position Index (TPI) calculation as proposed by Guisan et al. (1999). This implementation calculates the TPI for different scales and integrates these into one single grid. The hierarchical integration is achieved by starting with the standardized TPI values of the largest scale, then adding standardized values from smaller scales where the (absolute) values from the smaller scale exceed those from the larger scale. This integration scheme has been proposed by N. Zimmermann.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputDEM--
OutputTopographic Position Indexgrid, outputTPI--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Minimum Scaleinteger numberSCALE_MINkernel radius in cellsMinimum: 1 Default: 1
Maximum Scaleinteger numberSCALE_MAXkernel radius in cellsMinimum: 1 Default: 8
Number of Scalesinteger numberSCALE_NUM-Minimum: 2 Default: 3
Updateboolean, GUIUPDATEupdate view for each integration stepDefault: 0

Command Line


Usage: saga_cmd ta_morphometry 28 [-DEM ] [-TPI ] [-SCALE_MIN ] [-SCALE_MAX ] [-SCALE_NUM ]
  -DEM:      	Elevation
	grid, input
  -TPI:      	Topographic Position Index
	grid, output
  -SCALE_MIN:	Minimum Scale
	integer number
	Minimum: 1
	Default: 1
  -SCALE_MAX:	Maximum Scale
	integer number
	Minimum: 1
	Default: 8
  -SCALE_NUM:	Number of Scales
	integer number
	Minimum: 2
	Default: 3