SAGA-GIS Tool Library Documentation (v8.1.0)

Tool Overland Flow

A simple overland flow simulation.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputDEM--
Roughness (*)Grid, input, optionalROUGHNESSKs Strickler = 1/n Manning-
Interception Capacity [mm] (*)Grid, input, optionalINTER_MAX--
Ponding Capacity [mm] (*)Grid, input, optionalPOND_MAX--
Infiltration Capacity [mm/h] (*)Grid, input, optionalINFIL_MAX--
Precipitation [mm/h] (*)Grid, input, optionalPRECIP--
Potential Evapotranspiration [mm/h] (*)Grid, input, optionalET_POT--
OutputInterception [mm]Grid, outputINTERCEPT--
Ponding [mm]Grid, outputPONDING--
Infiltration [mm]Grid, outputINFILTRAT--
Flow [mm]Grid, outputFLOW--
Velocity [m/h] (*)Grid, output, optionalVELOCITY--
Overland Flow Summary (*)Table, output, optionalSUMMARY--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
DefaultFloating pointROUGHNESS_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 20.000000
TypeChoiceSTRICKLERKs Strickler = 1/n Gauckler-ManningAvailable Choices:
[0] Strickler Ks, [m^1/3 / s]
[1] Gauckler-Manning n, [s / m^1/3]
Default: 0
DefaultFloating pointINTER_MAX_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.000000
DefaultFloating pointPOND_MAX_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.000000
DefaultFloating pointINFIL_MAX_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.000000
Weather Grid SystemGrid systemWEATHER--
DefaultFloating pointPRECIP_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.000000
DefaultFloating pointET_POT_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000
Default: 0.000000
ResetBooleanRESETIf checked storages (flow, ponding, interception) and sinks (infiltration) will be set to zero.Default: 1
Simulation Time [h]Floating pointTIME_STOPSimulation time in hours.Minimum: 0.000000
Default: 6.000000
Time Step AdjustmentFloating pointTIME_STEPChoosing a lower value will result in a better numerical precision but also in a longer calculation time.Minimum: 0.010000
Maximum: 1.000000
Default: 0.500000
Overland Flow SummaryBooleanFLOW_OUTReport the amount of overland flow that left the covered area.Default: 0
Map Update Frequency [Minutes]Floating pointTIME_UPDATEMap update frequency in minutes. Set to zero to update each simulation time step.Minimum: 0.000000
Default: 1.000000
Fixed Color Stretch for FlowBooleanUPDATE_FLOW_FIXED-Default: 0
Fixed Color StretchValue rangeUPDATE_FLOW_RANGE--
Fixed Color Stretch for VelocityBooleanUPDATE_VELO_FIXED-Default: 1
Fixed Color StretchValue rangeUPDATE_VELO_RANGE--
(*) optional

Command-line

Usage: saga_cmd sim_hydrology 9 [-DEM <str>] [-ROUGHNESS <str>] [-ROUGHNESS_DEFAULT <double>] [-STRICKLER <str>] [-INTER_MAX <str>] [-INTER_MAX_DEFAULT <double>] [-POND_MAX <str>] [-POND_MAX_DEFAULT <double>] [-INFIL_MAX <str>] [-INFIL_MAX_DEFAULT <double>] [-INTERCEPT <str>] [-PONDING <str>] [-INFILTRAT <str>] [-FLOW <str>] [-VELOCITY <str>] [-PRECIP <str>] [-PRECIP_DEFAULT <double>] [-ET_POT <str>] [-ET_POT_DEFAULT <double>] [-RESET <str>] [-TIME_STOP <double>] [-TIME_STEP <double>] [-FLOW_OUT <str>] [-SUMMARY <str>] [-TIME_UPDATE <double>] [-UPDATE_FLOW_FIXED <str>] [-UPDATE_FLOW_RANGE_MIN <double>] [-UPDATE_FLOW_RANGE_MAX <double>] [-UPDATE_VELO_FIXED <str>] [-UPDATE_VELO_RANGE_MIN <double>] [-UPDATE_VELO_RANGE_MAX <double>]
  -DEM:<str>                     	Elevation
	Grid, input
  -ROUGHNESS:<str>               	Roughness
	Grid, input, optional
  -ROUGHNESS_DEFAULT:<double>    	Default
	Floating point
	Minimum: 0.000000
	Default: 20.000000
  -STRICKLER:<str>               	Type
	Choice
	Available Choices:
	[0] Strickler Ks, [m^1/3 / s]
	[1] Gauckler-Manning n, [s / m^1/3]
	Default: 0
  -INTER_MAX:<str>               	Interception Capacity [mm]
	Grid, input, optional
  -INTER_MAX_DEFAULT:<double>    	Default
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -POND_MAX:<str>                	Ponding Capacity [mm]
	Grid, input, optional
  -POND_MAX_DEFAULT:<double>     	Default
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -INFIL_MAX:<str>               	Infiltration Capacity [mm/h]
	Grid, input, optional
  -INFIL_MAX_DEFAULT:<double>    	Default
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -INTERCEPT:<str>               	Interception [mm]
	Grid, output
  -PONDING:<str>                 	Ponding [mm]
	Grid, output
  -INFILTRAT:<str>               	Infiltration [mm]
	Grid, output
  -FLOW:<str>                    	Flow [mm]
	Grid, output
  -VELOCITY:<str>                	Velocity [m/h]
	Grid, output, optional
  -PRECIP:<str>                  	Precipitation [mm/h]
	Grid, input, optional
  -PRECIP_DEFAULT:<double>       	Default
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -ET_POT:<str>                  	Potential Evapotranspiration [mm/h]
	Grid, input, optional
  -ET_POT_DEFAULT:<double>       	Default
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -RESET:<str>                   	Reset
	Boolean
	Default: 1
  -TIME_STOP:<double>            	Simulation Time [h]
	Floating point
	Minimum: 0.000000
	Default: 6.000000
  -TIME_STEP:<double>            	Time Step Adjustment
	Floating point
	Minimum: 0.010000
	Maximum: 1.000000
	Default: 0.500000
  -FLOW_OUT:<str>                	Overland Flow Summary
	Boolean
	Default: 0
  -SUMMARY:<str>                 	Overland Flow Summary
	Table, output, optional
  -TIME_UPDATE:<double>          	Map Update Frequency [Minutes]
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -UPDATE_FLOW_FIXED:<str>       	Fixed Color Stretch for Flow
	Boolean
	Default: 0
  -UPDATE_FLOW_RANGE_MIN:<double>	Fixed Color Stretch
	Value range
  -UPDATE_FLOW_RANGE_MAX:<double>	Fixed Color Stretch
	Value range
  -UPDATE_VELO_FIXED:<str>       	Fixed Color Stretch for Velocity
	Boolean
	Default: 1
  -UPDATE_VELO_RANGE_MIN:<double>	Fixed Color Stretch
	Value range
  -UPDATE_VELO_RANGE_MAX:<double>	Fixed Color Stretch
	Value range