Note: This document is for an older version of GRASS GIS that is outdated. You should upgrade, and read the current manual page.
NAME
r.topmodel - Simulates TOPMODEL which is a physically based hydrologic model.
KEYWORDS
raster, hydrology
SYNOPSIS
r.topmodel
r.topmodel help
r.topmodel [-i] [basin=name] [elevation=name] [depressionless=name] [direction=name] [belevation=name] [topidx=name] [nidxclass=integer] idxstats=name parameters=name input=name output=name [Qobs=name] [timestep=integer] [idxclass=integer] [--overwrite] [--verbose] [--quiet]
Flags:
- -i
- Input data given for (o/i)
- --overwrite
- Allow output files to overwrite existing files
- --verbose
- Verbose module output
- --quiet
- Quiet module output
Parameters:
- basin=name
- Name of input basin raster map
- Created by r.water.outlet (MASK)
- elevation=name
- Name of elevation raster map
- depressionless=name
- Name for output depressionless elevation raster map
- direction=name
- Name for output direction map for depressionless elevation raster map
- belevation=name
- Name for output basin elevation raster map (o/i)
- MASK applied
- topidx=name
- Name for output topographic index ln(a/tanB) raster map
- MASK applied
- nidxclass=integer
- Number of topographic index classes
- Default: 30
- idxstats=name
- Name of topographic index statistics file (o/i)
- parameters=name
- Name of TOPMODEL parameters file
- input=name
- Name of rainfall and potential evapotranspiration data file
- output=name
- Name for output file
- Qobs=name
- Name for observed flow file
- timestep=integer
- Time step
- idxclass=integer
- Topographic index class
DESCRIPTION
r.topmodel simulates TOPMODEL which is a physically based
hydrologic model.
Note: (i) means input; (o) means output; (o/i) means input or output
The -i flag indicates that input data are given for (o/i). Without this
flag, all inputs (i) and intermediate outputs (o/i) should be given. For
example, [belevation] map will be created from [elevation] and [basin] in every
run. However, given the same [elevation] and [basin], [belevation] output will
be the same all the time, so r.topmodel can directly take [belevation] as an
input with this flag to save time.
Selected Parameters:
- depressionless map is created as follows:
r.fill.dir input=elevation elev=depressionless dir=direction type=grass
- belevation map is created from [elevation] with [basin] mask applied:
r.mapcalc "belevation = if(basin == 0 || isnull(basin), null(), elevation)"
- topidx map is created as follows:
r.topidx input=elevation output=topidx
- Qobs
- Compare simulated flows with observed flows and calculate model
efficiency.
REFERENCES
K. Beven, R. Lamb, P. Quinn, R. Romanowicz, and J. Freer.
TOPMODEL, in V.P. Singh (Ed.). Computer Models of Watershed Hydrology.
Water Resources Publications, 1995.
S.C. Liaw, Streamflow simulation using a physically based hydrologic
model in humid forested watersheds (Dissertation).
Colorado State University, CO. p163, 1988.
SEE ALSO
r.fill.dir,
r.mapcalc,
r.topidx
How to run r.topmodel
AUTHORS
Main algorithm sources are rewritten in C based on TMOD9502.FOR.
Thanks to Keith Beven.
GRASS port by Huidae Cho
Hydro Laboratory, Kyungpook National University, South Korea
Last changed: $Date: 2011-11-08 02:23:26 -0800 (Tue, 08 Nov 2011) $
Main index - raster index - Full index
© 2003-2014 GRASS Development Team