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

Johnson, D.L., Miller, A.C. (1997): A spatially distributed hydrological model utilizing raster data structures. Computers & Geosciences, Vol.23, No.3, pp.267-272. http://www.sciencedirect.com/science/article/pii/S0098300496000842.
MacArthur, R., DeVries, J.J. (1993): Introduction and Application of Kinematic Wave Routing Techniques Using HEC-1. US Army Corps of Engineers, Institute for Water Resources, Hydrologic Engineering Center (HEC). online.

Author: O. Conrad (c) 2003
Menu: Simulation|Hydrology

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Elevation	Grid, input	`DEM`	-	-
	Manning Roughness (*)	Grid, input, optional	`ROUGHNESS`	-	-
	Gauges (*)	Shapes, input, optional	`GAUGES`	-	-
Output	Runoff	Grid, output	`FLOW`	-	-
Output	Flow at Gauges (*)	Table, output, optional	`GAUGES_FLOW`	-	-
Options	Grid System	Grid system	`PARAMETERS_GRID_SYSTEM`	-	-
	Default	Floating point	`ROUGHNESS_DEFAULT`	default value if no grid has been selected	Minimum: 0.000000 Default: 0.030000
	Simulation Time [h]	Floating point	`TIME_SPAN`	-	Minimum: 0.000000 Default: 1.000000
	Simulation Time Step [min]	Floating point	`TIME_STEP`	-	Minimum: 0.000000 Default: 1.000000
	Map Update Frequency [min]	Floating point	`TIME_UPDATE`	If zero each simulation time step will update the flow map.	Minimum: 0.000000 Default: 1.000000
	Maximum Iterations	Integer	`MAXITER`	-	Minimum: 1 Default: 100
	Epsilon	Floating point	`EPSILON`	-	Minimum: 0.000000 Default: 0.000100
	Flow Routing	Choice	`ROUTING`	-	Available Choices: [0] Deterministic 8 [1] Multiple Flow Direction Default: 1
	Dynamic Water Surface	Boolean	`DYNAMIC`	-	Default: 1
	Reset	Boolean	`FLOW_RESET`	-	Default: 1
	Precipitation [mm]	Floating point	`P_RATE`	-	Default: 10.000000
	Precipitation	Choice	`P_DISTRIB`	-	Available Choices: [0] Homogenous [1] Above Elevation [2] Left Half Default: 0
	Above Elevation	Floating point	`P_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