Tool Vertical Distance to Channel Network
This tool calculates the vertical distance to a channel network base level. The algorithm consists of two major steps:
1. Interpolation of a channel network base level elevation
2. Subtraction of this base level from the original elevations
- Author: O.Conrad (c) 2002
- Menu: Terrain Analysis|Channels
Parameters
Name | Type | Identifier | Description | Constraints | |
---|---|---|---|---|---|
Input | Elevation | Grid, input | ELEVATION | A grid that contains elevation data. | - |
Channel Network | Grid, input | CHANNELS | A grid providing information about the channel network. It is assumed that no-data cells are not part of the channel network. Vice versa all others cells are recognised as channel network members. | - | |
Output | Vertical Distance to Channel Network | Grid, output | DISTANCE | The resulting grid gives the altitude above the channel network in the same units as the elevation data. | - |
Channel Network Base Level (*) | Grid, output, optional | BASELEVEL | This optional grid output contains the interpolated channel network base level elevations. | - | |
Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
Tension Threshold | Floating point | THRESHOLD | Maximum change in elevation units (e.g. meter), iteration is stopped once maximum change reaches this threshold. | Minimum: 0.000000 Default: 1.000000 | |
Maximum Iterations | Integer | MAXITER | Maximum number of iterations, ignored if set to zero | Minimum: 0 Default: 0 | |
Keep Base Level below Surface | Boolean | NOUNDERGROUND | - | Default: 1 | |
(*) optional |
Command-line
Usage: saga_cmd ta_channels 3 [-ELEVATION <str>] [-CHANNELS <str>] [-DISTANCE <str>] [-BASELEVEL <str>] [-THRESHOLD <double>] [-MAXITER <num>] [-NOUNDERGROUND <str>] -ELEVATION:<str> Elevation Grid, input -CHANNELS:<str> Channel Network Grid, input -DISTANCE:<str> Vertical Distance to Channel Network Grid, output -BASELEVEL:<str> Channel Network Base Level Grid, output, optional -THRESHOLD:<double> Tension Threshold Floating point Minimum: 0.000000 Default: 1.000000 -MAXITER:<num> Maximum Iterations Integer Minimum: 0 Default: 0 -NOUNDERGROUND:<str> Keep Base Level below Surface Boolean Default: 1