Tool TPI Based Landform Classification
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.
References
- 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) 2011
- Menu: Terrain Analysis|Terrain Classification
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | Elevation | Grid (input) | DEM | - | - |
| Output | Landforms | Grid (output) | LANDFORMS | - | - |
| Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
| Small Scale | Value range | RADIUS_A | kernel radius in map units; defines an annulus if inner radius is greater than zero | - |
| Large Scale | Value range | RADIUS_B | kernel radius in map units; defines an annulus if inner radius is greater than zero | - |
| 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 | DW_IDW_POWER | - | Minimum: 0.000000
Default: 2.000000 |
| Bandwidth | Floating point | DW_BANDWIDTH | Bandwidth for exponential and Gaussian weighting | Minimum: 0.000000
Default: 1.000000 |
Command-line
Usage: saga_cmd ta_morphometry 19 [-DEM <str>] [-LANDFORMS <str>] [-RADIUS_A_MIN <double>] [-RADIUS_A_MAX <double>] [-RADIUS_B_MIN <double>] [-RADIUS_B_MAX <double>] [-DW_WEIGHTING <str>] [-DW_IDW_POWER <double>] [-DW_BANDWIDTH <double>]
-DEM:<str> Elevation
Grid (input)
-LANDFORMS:<str> Landforms
Grid (output)
-RADIUS_A_MIN:<double> Small Scale
Value range
-RADIUS_A_MAX:<double> Small Scale
Value range
-RADIUS_B_MIN:<double> Large Scale
Value range
-RADIUS_B_MAX:<double> Large Scale
Value range
-DW_WEIGHTING:<str> Weighting Function
Choice
Available Choices:
[0] no distance weighting
[1] inverse distance to a power
[2] exponential
[3] gaussian
Default: 0
-DW_IDW_POWER:<double> Power
Floating point
Minimum: 0.000000
Default: 2.000000
-DW_BANDWIDTH:<double> Bandwidth
Floating point
Minimum: 0.000000
Default: 1.000000