Tool Multi-Scale Topographic Position Index (TPI)
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
- toposcale.aml script by N.Zimmermann
- Guisan, A., Weiss, S.B., Weiss, A.D. (1999): GLM versus CCA spatial modeling of plant species distribution. Plant Ecology 143: 107-122.
- Weiss, A.D. (2000): Topographic Position and Landforms Analysis. Poster http://www.jennessent.com/downloads/tpi-poster-tnc_18x22.pdf.
- Wilson, J.P. & Gallant, J.C. (2000): Primary Topographic Attributes. In: Wilson, J.P. & Gallant, J.C. [Eds.]: Terrain Analysis: Principles and Applications, John Wiley & Sons, p.51-85.
- Author: O.Conrad (c) 2016
- Menu: Terrain Analysis|Morphometry
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | Elevation | Grid, input | DEM | - | - |
| Output | Topographic Position Index | Grid, output | TPI | - | - |
| Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
| Minimum Scale | Integer | SCALE_MIN | kernel radius in cells | Minimum: 1
Default: 1 |
| Maximum Scale | Integer | SCALE_MAX | kernel radius in cells | Minimum: 1
Default: 8 |
| Number of Scales | Integer | SCALE_NUM | - | Minimum: 2
Default: 3 |
| Update | Boolean, GUI | UPDATE | update view for each integration step | Default: 0 |
Command-line
Usage: saga_cmd ta_morphometry 28 [-DEM <str>] [-TPI <str>] [-SCALE_MIN <num>] [-SCALE_MAX <num>] [-SCALE_NUM <num>]
-DEM:<str> Elevation
Grid, input
-TPI:<str> Topographic Position Index
Grid, output
-SCALE_MIN:<num> Minimum Scale
Integer
Minimum: 1
Default: 1
-SCALE_MAX:<num> Maximum Scale
Integer
Minimum: 1
Default: 8
-SCALE_NUM:<num> Number of Scales
Integer
Minimum: 2
Default: 3