Module 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.
- Wilson, J.P. & Gallant, J.C. (2000): Terrain Analysis - Principles and Applications.
- 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 | Grid system | - |
| Radius | Value range | RADIUS_A | radius in map units | - |
| Radius | Value range | RADIUS_B | radius in map units | - |
| Weighting Function | Choice | DW_WEIGHTING | - | Available Choices:
[0] no distance weighting
[1] inverse distance to a power
[2] exponential
[3] gaussian weighting
Default: 0 |
| Inverse Distance Weighting Power | Floating point | DW_IDW_POWER | - | Minimum: 0.000000
Default: 1.000000 |
| Inverse Distance Offset | Boolean | DW_IDW_OFFSET | Calculates weights for distance plus one, avoiding division by zero for zero distances | Default: 1 |
| Gaussian and Exponential Weighting Bandwidth | Floating point | DW_BANDWIDTH | - | Minimum: 0.000000
Default: 75.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_IDW_OFFSET <str>] [-DW_BANDWIDTH <double>]
-DEM:<str> Elevation
Grid (input)
-LANDFORMS:<str> Landforms
Grid (output)
-RADIUS_A_MIN:<double> Radius
Value range
-RADIUS_A_MAX:<double> Radius
Value range
-RADIUS_B_MIN:<double> Radius
Value range
-RADIUS_B_MAX:<double> Radius
Value range
-DW_WEIGHTING:<str> Weighting Function
Choice
Available Choices:
[0] no distance weighting
[1] inverse distance to a power
[2] exponential
[3] gaussian weighting
Default: 0
-DW_IDW_POWER:<double> Inverse Distance Weighting Power
Floating point
Minimum: 0.000000
Default: 1.000000
-DW_IDW_OFFSET:<str> Inverse Distance Offset
Boolean
Default: 1
-DW_BANDWIDTH:<double> Gaussian and Exponential Weighting Bandwidth
Floating point
Minimum: 0.000000
Default: 75.000000