r.topmodel1grass
Simulates topmodel which is a physically based hydrologic model.
Usage
r.topmodel
r.topmodel --help
r.topmodel [-p]
parameters=name
topidxstats=name
input=name
output=name
[timestep=integer]
[topidxclass=integer]
[topidx=name]
[ntopidxclasses=integer]
[outtopidxstats=name]
[--overwrite]
[--help]
[--verbose]
[--quiet]
[--ui]
Keywords
raster, hydrology, model
Overview
r.topmodel simulates TOPMODEL which is a physically based hydrologic model.
Parameters description
parameters-
This file contains TOPMODEL parameters that describe the study area. Any lines starting with a # sign or empty lines are ignored.
# Subcatchment nameSubcatchment 1################################################################################# A [m^2]: Total subcatchment area3.31697E+07################################################################################# qs0 [m/h]: Initial subsurface flow per unit area# "The first streamflow input is assumed to represent# only the subsurface flow contribution in the watershed."# - Liaw (1988)0.000075# lnTe [ln(m^2/h)]: Areal average of the soil surface transmissivity4.# m [m]: Parameter controlling the decline rate of transmissivity# See Beven and Kirkby (1979)0.0125# Sr0 [m]: Initial root zone storage deficit0.0025# Srmax [m]: Maximum root zone storage deficit0.041# td [h]: Unsaturated zone time delay per unit storage deficit if greater than 0# OR# -alpha: Effective vertical hydraulic gradient if not greater than 0.## For example, -10 means alpha=10.60.# vch [m/h]: Main channel routing velocity20000.# vr [m/h]: Internal subcatchment routing velocity10000.################################################################################# infex: Calculate infiltration excess if not zero (integer)0# K0 [m/h]: Surface hydraulic conductivity2.# psi [m]: Wetting front suction0.1# dtheta: Water content change across the wetting front0.1################################################################################# d [m]: Distance from the catchment outlet# The first value should be the mainstream distance from# the subcatchment outlet to the catchment outlet.# Ad_r: Cumulative area ratio of subcatchment (0.0 to 1.0)# The first and last values should be 0 and 1, respectively.# d Ad_r0 0.01000 0.22000 0.43000 0.64000 0.85000 1.0
input
-
This file contains observed weather data.
# dt [h]: Time step24################################################################################# R [m/dt]: Rainfall# Ep [m/dt]: Potential evapotranspiration# R Ep0.000033 0.0000000.000053 0.0119380.004821 0.000000...
timestep-
If a time step is specified, output will be generated for the specific time step in addition to the summary and total flows at the outlet. This parameter can be combined with
topidxclassto specify a time step and topographic index class at the same time. If notopidxclassis given, output will be generated for all the topographic index classes.
toptopidxclass-
If a topographic index class is specified, output will be generated for the given topographic index class. This parameter can be combined with
timestep. If notimestepis given, output will be generated for all the time steps.
topidx,ntoptopidxclasses,outtoptopidxstats-
The
topidxmap can optionally be used for creating a new topographic index statistics file. This map has to be already clipped to the catchment boundary. The entire range of topographic index values will be divided intontoptopidxclassesand the area ratio of each class will be reported in theouttoptopidxstatsfile. These three parameters can be omitted unless a newtopidxstatsfile needs to be created.
References
- •
-
Beven, K. J., 1984. Infiltration into a class of vertically non-uniform soils. Hydrological Sciences Journal 29 (4), 425-434.
- •
-
Beven, K. J., Kirkby, M. J., 1979. A physically based, variable contributing area model of basin hydrology. Hydrological Sciences Bulletin 24 (1), 43-69.
- •
-
Beven K. J., R. Lamb, P. Quinn, R. Romanowicz, and J. Freer, 1995. TOPMODEL, in V.P. Singh (Ed.). Computer Models of Watershed Hydrology. Water Resources Publications.
- •
-
Cho, H., 2000. GIS Hydrological Modeling System by Using Programming Interface of GRASS. Master’s Thesis, Department of Civil Engineering, Kyungpook National University, South Korea.
- •
-
Liaw, S. C., 1988. Streamflow Simulation Using a Physically Based Hydrologic Model in Humid Forested Watersheds. Dissertation, Colorado State University, CO. p163.
- •
-
Morel-Seytoux, H. J., Khanji, J., 1974. Derivation of an equation of infiltration. Water Resources Research 10 (4), 795-800.
Source code
Available at: r.topmodel source code (history)
Accessed: Monday Feb 24 17:50:55 2025
Main index | Raster index | Topics index | Keywords index | Graphical index | Full index
© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual
Releases
10 releases since Debian 4.0 (Etch); the text changed 9 times.