Terrain Flooding

Author: V. Wichmann (c) 2022
Menu: Terrain Analysis | Hydrology | Miscellaneous

Description

The tool allows one to flood a digital elevation model for a given water level. The water level can be provided either as absolute height or relative to the DEM. If the water level is given relative to the DEM, the tool can model a constant water level starting from the seed cell, or a water level that is always relative to the currently processed cell. This way also inclined water surfaces, e.g. along a river, can be modelled. Note that this usually requires rather small relative water levels in order to prevent the flooding of the complete DEM; the functionality is most suited to generate a segment (connected component) of a river bed.

Parameters

	Name	Type	Identifier	Description	Constraints
Input	DEM	grid, input	`DEM`	The digital elevation model to flood.	-
Input	Seed Points	shapes, input	`SEEDS`	The point(s) from where to start the flooding.	-
Output	Water Body	grid, output	`WATER_BODY`	The extent of the water body, labeled with local water depth [map units].	-
Output	Flooded DEM	grid, output, optional	`DEM_FLOODED`	The flooded digital elevation model.	-
Options	Grid System	grid system	`PARAMETERS_GRID_SYSTEM`	-	-
	Water Level	table field	`WATER_LEVEL`	The attribute field with the local water level, given either relative to the DEM or as absolute height [map units].	-
	Default	floating point number	`WATER_LEVEL_DEFAULT`	default value if no attribute has been selected	Default: 0.500000
	Water Level Reference	choice	`LEVEL_REFERENCE`	-	Available Choices: [0] level is given relative to DEM [1] level is given as absolute water height Default: 0
	Constant Water Level	boolean	`CONSTANT_LEVEL`	Model the water level as constant. Otherwise the specified level is always taken as relative to the currently processed cell. This option is only available if the water level reference is relative to the DEM.	Default: 1

Command Line


Usage: saga_cmd ta_hydrology 32 [-DEM ] [-SEEDS ] [-WATER_LEVEL ] [-WATER_LEVEL_DEFAULT ] [-LEVEL_REFERENCE ] [-CONSTANT_LEVEL ] [-WATER_BODY ] [-DEM_FLOODED ]
  -DEM:                   	DEM
	grid, input
  -SEEDS:                 	Seed Points
	shapes, input
  -WATER_LEVEL:           	Water Level
	table field
  -WATER_LEVEL_DEFAULT:	Default
	floating point number
	Default: 0.500000
  -LEVEL_REFERENCE:       	Water Level Reference
	choice
	Available Choices:
	[0] level is given relative to DEM
	[1] level is given as absolute water height
	Default: 0
  -CONSTANT_LEVEL:        	Constant Water Level
	boolean
	Default: 1
  -WATER_BODY:            	Water Body
	grid, output
  -DEM_FLOODED:           	Flooded DEM
	grid, output, optional