SAGA-GIS Tool Library Documentation (v7.7.0)

Tool Overland Flow (Kinematic Wave)

This is a simple tool that simulates overland flow with 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, inputDEM--
Manning Roughness (*)Grid, input, optionalROUGHNESS--
Gauges (*)Shapes, input, optionalGAUGES--
OutputRunoffGrid, outputFLOW--
Flow at Gauges (*)Table, output, optionalGAUGES_FLOW--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
DefaultFloating pointROUGHNESS.Defaultdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.030000
Simulation Time [h]Floating pointTIME_SPAN-Minimum: 0.000000
Default: 1.000000
Simulation Time Step [min]Floating pointTIME_STEP-Minimum: 0.000000
Default: 1.000000
Map Update Frequency [min]Floating pointTIME_UPDATEIf zero each simulation time step will update the flow map.Minimum: 0.000000
Default: 1.000000
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
Dynamic Water SurfaceBooleanDYNAMIC-Default: 1
ResetBooleanFLOW_RESET-Default: 1
Precipitation [mm]Floating pointP_RATE-Default: 10.000000
PrecipitationChoiceP_DISTRIB-Available Choices:
[0] Homogenous
[1] Above Elevation
[2] Left Half
Default: 0
Above ElevationFloating pointP_THRESHOLD-Default: 0.000000
(*) optional

Command-line

Usage: saga_cmd sim_hydrology 1 [-DEM <str>] [-ROUGHNESS <str>] [-ROUGHNESS.Default <double>] [-FLOW <str>] [-GAUGES_FLOW <str>] [-GAUGES <str>] [-TIME_SPAN <double>] [-TIME_STEP <double>] [-TIME_UPDATE <double>] [-MAXITER <num>] [-EPSILON <double>] [-ROUTING <str>] [-DYNAMIC <str>] [-FLOW_RESET <str>] [-P_RATE <double>] [-P_DISTRIB <str>] [-P_THRESHOLD <double>]
  -DEM:<str>                 	Elevation
	Grid, input
  -ROUGHNESS:<str>           	Manning Roughness
	Grid, input, optional
  -ROUGHNESS.Default:<double>	Default
	Floating point
	Minimum: 0.000000
	Default: 0.030000
  -FLOW:<str>                	Runoff
	Grid, output
  -GAUGES_FLOW:<str>         	Flow at Gauges
	Table, output, optional
  -GAUGES:<str>              	Gauges
	Shapes, input, optional
  -TIME_SPAN:<double>        	Simulation Time [h]
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TIME_STEP:<double>        	Simulation Time Step [min]
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TIME_UPDATE:<double>      	Map Update Frequency [min]
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -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
  -DYNAMIC:<str>             	Dynamic Water Surface
	Boolean
	Default: 1
  -FLOW_RESET:<str>          	Reset
	Boolean
	Default: 1
  -P_RATE:<double>           	Precipitation [mm]
	Floating point
	Default: 10.000000
  -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