Overland Flow (Kinematic Wave)

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

Description

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.

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 number	`ROUGHNESS_DEFAULT`	default value if no grid has been selected	Minimum: 0.000000 Default: 0.030000
	Simulation Time [h]	floating point number	`TIME_SPAN`	-	Minimum: 0.000000 Default: 1.000000
	Simulation Time Step [min]	floating point number	`TIME_STEP`	-	Minimum: 0.000000 Default: 1.000000
	Map Update Frequency [min]	floating point number	`TIME_UPDATE`	If zero each simulation time step will update the flow map.	Minimum: 0.000000 Default: 1.000000
	Maximum Iterations	integer number	`MAXITER`	-	Minimum: 1 Default: 100
	Epsilon	floating point number	`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 number	`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 number	`P_THRESHOLD`	-	Default: 0.000000

Command Line


Usage: saga_cmd sim_hydrology 1 [-DEM ] [-ROUGHNESS ] [-ROUGHNESS_DEFAULT ] [-FLOW ] [-GAUGES_FLOW ] [-GAUGES ] [-TIME_SPAN ] [-TIME_STEP ] [-TIME_UPDATE ] [-MAXITER ] [-EPSILON ] [-ROUTING ] [-DYNAMIC ] [-FLOW_RESET ] [-P_RATE ] [-P_DISTRIB ] [-P_THRESHOLD ]
  -DEM:                 	Elevation
	grid, input
  -ROUGHNESS:           	Manning Roughness
	grid, input, optional
  -ROUGHNESS_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Default: 0.030000
  -FLOW:                	Runoff
	grid, output
  -GAUGES_FLOW:         	Flow at Gauges
	table, output, optional
  -GAUGES:              	Gauges
	shapes, input, optional
  -TIME_SPAN:        	Simulation Time [h]
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -TIME_STEP:        	Simulation Time Step [min]
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -TIME_UPDATE:      	Map Update Frequency [min]
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -MAXITER:             	Maximum Iterations
	integer number
	Minimum: 1
	Default: 100
  -EPSILON:          	Epsilon
	floating point number
	Minimum: 0.000000
	Default: 0.000100
  -ROUTING:             	Flow Routing
	choice
	Available Choices:
	[0] Deterministic 8
	[1] Multiple Flow Direction
	Default: 1
  -DYNAMIC:             	Dynamic Water Surface
	boolean
	Default: 1
  -FLOW_RESET:          	Reset
	boolean
	Default: 1
  -P_RATE:           	Precipitation [mm]
	floating point number
	Default: 10.000000
  -P_DISTRIB:           	Precipitation
	choice
	Available Choices:
	[0] Homogenous
	[1] Above Elevation
	[2] Left Half
	Default: 0
  -P_THRESHOLD:      	Above Elevation
	floating point number
	Default: 0.000000