SAGA-GIS Tool Library Documentation (v8.2.1)

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

Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputELEVATIONA grid that contains elevation data.-
Channel NetworkGrid, inputCHANNELSA 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.-
OutputVertical Distance to Channel NetworkGrid, outputDISTANCEThe resulting grid gives the altitude above the channel network in the same units as the elevation data.-
Channel Network Base Level (*)Grid, output, optionalBASELEVELThis optional grid output contains the interpolated channel network base level elevations.-
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Tension ThresholdFloating pointTHRESHOLDMaximum change in elevation units (e.g. meter), iteration is stopped once maximum change reaches this threshold.Minimum: 0.000000
Default: 1.000000
Maximum IterationsIntegerMAXITERMaximum number of iterations, ignored if set to zeroMinimum: 0
Default: 0
Keep Base Level below SurfaceBooleanNOUNDERGROUND-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