SAGA-GIS Tool Library Documentation (v7.2.0)

Tool Kinematic Wave Overland Flow

This is a simple tool that simulates overland flow by a kinematic wave approach. It is not designed for operational usage. Rather it should give an idea about some principles of dynamic simulation techniques and thus it might become a starting point for more sophisticated and applicable simulation tools.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid (input)DEM--
Manning Roughness (*)Grid (optional input)ROUGHNESS--
Gauges (*)Shapes (optional input)GAUGES--
OutputRunoffGrid (output)FLOW--
Flow at Gauges (*)Table (optional output)GAUGES_FLOW--
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
DefaultFloating pointROUGHNESS_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.030000
ResetBooleanFLOW_RESET-Default: 1
Simulation Time [h]Floating pointTIME_SPAN-Minimum: 0.000000
Default: 24.000000
Simulation Time Step [h]Floating pointTIME_STEP-Minimum: 0.000000
Default: 0.100000
Maximum IterationsIntegerMAXITER-Minimum: 1
Default: 100
EpsilonFloating pointEPSILON-Minimum: 0.000000
Default: 0.000100
Flow RoutingChoiceROUTING-Available Choices:
[0] Deterministic 8
[1] Multiple Flow Direction
Default: 1
PrecipitationChoiceP_DISTRIB-Available Choices:
[0] Homogenous
[1] Above Elevation
[2] Left Half
Default: 0
Above ElevationFloating pointP_THRESHOLD-Default: 0.000000
Precipitation [mm]Floating pointP_RATE-Default: 10.000000
(*) optional

Command-line

Usage: saga_cmd sim_hydrology 1 [-DEM <str>] [-ROUGHNESS <str>] [-ROUGHNESS_DEFAULT <double>] [-FLOW <str>] [-FLOW_RESET <str>] [-GAUGES_FLOW <str>] [-GAUGES <str>] [-TIME_SPAN <double>] [-TIME_STEP <double>] [-MAXITER <num>] [-EPSILON <double>] [-ROUTING <str>] [-P_DISTRIB <str>] [-P_THRESHOLD <double>] [-P_RATE <double>]
  -DEM:<str>                 	Elevation
	Grid (input)
  -ROUGHNESS:<str>           	Manning Roughness
	Grid (optional input)
  -ROUGHNESS_DEFAULT:<double>	Default
	Floating point
	Minimum: 0.000000
	Default: 0.030000
  -FLOW:<str>                	Runoff
	Grid (output)
  -FLOW_RESET:<str>          	Reset
	Boolean
	Default: 1
  -GAUGES_FLOW:<str>         	Flow at Gauges
	Table (optional output)
  -GAUGES:<str>              	Gauges
	Shapes (optional input)
  -TIME_SPAN:<double>        	Simulation Time [h]
	Floating point
	Minimum: 0.000000
	Default: 24.000000
  -TIME_STEP:<double>        	Simulation Time Step [h]
	Floating point
	Minimum: 0.000000
	Default: 0.100000
  -MAXITER:<num>             	Maximum Iterations
	Integer
	Minimum: 1
	Default: 100
  -EPSILON:<double>          	Epsilon
	Floating point
	Minimum: 0.000000
	Default: 0.000100
  -ROUTING:<str>             	Flow Routing
	Choice
	Available Choices:
	[0] Deterministic 8
	[1] Multiple Flow Direction
	Default: 1
  -P_DISTRIB:<str>           	Precipitation
	Choice
	Available Choices:
	[0] Homogenous
	[1] Above Elevation
	[2] Left Half
	Default: 0
  -P_THRESHOLD:<double>      	Above Elevation
	Floating point
	Default: 0.000000
  -P_RATE:<double>           	Precipitation [mm]
	Floating point
	Default: 10.000000