SAGA-GIS Tool Library Documentation (v6.1.0)

Tool Burn Stream Network into DEM

Burns a stream network into a Digital Elevation Model (DEM). Stream cells have to be coded with valid data values, all other cells should be set to no data value. First two methods decrease . The third method ensures a steady downstream gradient. An elevation decrease is only applied, if a downstream cell is equally high or higher. You should provide a grid with flow directions for determination of downstream cells. The 'Sink Drainage Route Detection' tool offers such flow directions.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputDEMGrid (input)DEM--
StreamsGrid (input)STREAM--
Flow DirectionGrid (input)FLOWDIR--
OutputProcessed DEM (*)Grid (optional output)BURN--
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
MethodChoiceMETHOD-Available Choices:
[0] simply decrease cell's value by epsilon
[1] lower cell's value to neighbours minimum value minus epsilon
[2] trace stream network downstream
Default: 0
EpsilonFloating pointEPSILON-Minimum: 0.000000
Default: 1.000000
(*) optional

Command-line

Usage: saga_cmd ta_preprocessor 6 [-DEM <str>] [-BURN <str>] [-STREAM <str>] [-FLOWDIR <str>] [-METHOD <str>] [-EPSILON <double>]
  -DEM:<str>       	DEM
	Grid (input)
  -BURN:<str>      	Processed DEM
	Grid (optional output)
  -STREAM:<str>    	Streams
	Grid (input)
  -FLOWDIR:<str>   	Flow Direction
	Grid (input)
  -METHOD:<str>    	Method
	Choice
	Available Choices:
	[0] simply decrease cell's value by epsilon
	[1] lower cell's value to neighbours minimum value minus epsilon
	[2] trace stream network downstream
	Default: 0
  -EPSILON:<double>	Epsilon
	Floating point
	Minimum: 0.000000
	Default: 1.000000