SAGA 9.3.3 | Tool Library Documentation

TOPMODEL


Description

Simple Subcatchment Version of TOPMODEL Based on the 'TOPMODEL demonstration program v95.02' by Keith Beven (Centre for Research on Environmental Systems and Statistics, Institute of Environmental and Biological Sciences, Lancaster University, Lancaster LA1 4YQ, UK) and the C translation of the Fortran source codes implemented in GRASS. This program allows single or multiple subcatchment calculations but with single average rainfall and potential evapotranspiration inputs to the whole catchment. Subcatchment discharges are routed to the catchment outlet using a linear routing algorithm with constant main channel velocity and internal subcatchment routing velocity. The program requires ln(a/tanB) distributions for each subcatchment. These may be calculated using the GRIDATB program which requires raster elevation data as input. It is recommended that those data should be 50 m resolution or better. NOTE that TOPMODEL is not intended to be a traditional model package but is more a collection of concepts that can be used **** where appropriate ****. It is up to the user to verify that the assumptions are appropriate (see discussion in Beven et al.(1994). This version of the model will be best suited to catchments with shallow soils and moderate topography which do not suffer from excessively long dry periods. Ideally predicted contributing areas should be checked against what actually happens in the catchment. It includes infiltration excess calculations and parameters based on the exponential conductivity Green-Ampt model of Beven (HSJ, 1984) but if infiltration excess does occur it does so over whole area of a subcatchment. Spatial variability in conductivities can however be handled by specifying Ko parameter values for different subcatchments, even if they have the same ln(a/tanB) and routing parameters, ie. to represent different parts of the area. Note that time step calculations are explicit ie. SBAR at start of time step is used to determine contributing area. Thus with long (daily) time steps contributing area depends on initial value together with any volume filling effect of daily inputs. Also baseflow at start of time step is used to update SBAR at end of time step.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputTopographic Wetness Indexgrid, inputATANB--
Weather Recordstable, inputWEATHER--
OutputSoil Moisture Deficitgrid, output, optionalMOIST--
Simulation Outputtable, outputTABLE--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Precipitation [m / dt]table fieldRECORD_P--
Evapotranspiration [m / dt]table fieldRECORD_ET--
Date/Timetable fieldRECORD_DATE--
Time Step [h]floating point numberDTIME-Default: 1.000000
Number of Classesinteger numberNCLASSES-Minimum: 1 Default: 30
Initial subsurface flow per unit area [m/h]floating point numberP_QS0-Default: 0.000033
Areal average of ln(T0) = ln(Te) [ln(m_/h)]floating point numberP_LNTE-Default: 5.000000
Model parameter [m]floating point numberP_MODEL-Default: 0.032000
Initial root zone storage deficit [m]floating point numberP_SR0-Default: 0.002000
Maximum root zone storage deficit [m]floating point numberP_SRZMAX-Default: 0.050000
Unsaturated zone time delay per unit storage deficit [h]floating point numberP_SUZ_TD-Default: 50.000000
Main channel routing velocity [m/h]floating point numberP_VCH-Default: 3600.000000
Internal subcatchment routing velocity [m/h]floating point numberP_VR-Default: 3600.000000
Surface hydraulic conductivity [m/h]floating point numberP_K0-Default: 1.000000
Wetting front suction [m]floating point numberP_PSI-Default: 0.020000
Water content change across the wetting frontfloating point numberP_DTHETA-Default: 0.100000
Green-Ampt InfiltrationbooleanBINF-Default: 1

Command Line


Usage: saga_cmd sim_hydrology 2 [-ATANB ] [-MOIST ] [-WEATHER ] [-RECORD_P ] [-RECORD_ET ] [-RECORD_DATE ] [-TABLE ] [-DTIME ] [-NCLASSES ] [-P_QS0 ] [-P_LNTE ] [-P_MODEL ] [-P_SR0 ] [-P_SRZMAX ] [-P_SUZ_TD ] [-P_VCH ] [-P_VR ] [-P_K0 ] [-P_PSI ] [-P_DTHETA ] [-BINF ]
  -ATANB:      	Topographic Wetness Index
	grid, input
  -MOIST:      	Soil Moisture Deficit
	grid, output, optional
  -WEATHER:    	Weather Records
	table, input
  -RECORD_P:   	Precipitation [m / dt]
	table field
  -RECORD_ET:  	Evapotranspiration [m / dt]
	table field
  -RECORD_DATE:	Date/Time
	table field
  -TABLE:      	Simulation Output
	table, output
  -DTIME:   	Time Step [h]
	floating point number
	Default: 1.000000
  -NCLASSES:   	Number of Classes
	integer number
	Minimum: 1
	Default: 30
  -P_QS0:   	Initial subsurface flow per unit area [m/h]
	floating point number
	Default: 0.000033
  -P_LNTE:  	Areal average of ln(T0) = ln(Te) [ln(m_/h)]
	floating point number
	Default: 5.000000
  -P_MODEL: 	Model parameter [m]
	floating point number
	Default: 0.032000
  -P_SR0:   	Initial root zone storage deficit [m]
	floating point number
	Default: 0.002000
  -P_SRZMAX:	Maximum root zone storage deficit [m]
	floating point number
	Default: 0.050000
  -P_SUZ_TD:	Unsaturated zone time delay per unit storage deficit [h]
	floating point number
	Default: 50.000000
  -P_VCH:   	Main channel routing velocity [m/h]
	floating point number
	Default: 3600.000000
  -P_VR:    	Internal subcatchment routing velocity [m/h]
	floating point number
	Default: 3600.000000
  -P_K0:    	Surface hydraulic conductivity [m/h]
	floating point number
	Default: 1.000000
  -P_PSI:   	Wetting front suction [m]
	floating point number
	Default: 0.020000
  -P_DTHETA:	Water content change across the wetting front
	floating point number
	Default: 0.100000
  -BINF:       	Green-Ampt Infiltration
	boolean
	Default: 1