.TH r.topmodel 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.topmodel\fR\fR  - Simulates TOPMODEL which is a physically based hydrologic model.
.SH KEYWORDS
raster, hydrology
.SH SYNOPSIS
\fBr.topmodel\fR
.br
\fBr.topmodel help\fR
.br
\fBr.topmodel\fR [\-\fBi\fR]  [\fBbasin\fR=\fIstring\fR]   [\fBelevation\fR=\fIstring\fR]   [\fBdepressionless\fR=\fIstring\fR]   [\fBdirection\fR=\fIstring\fR]   [\fBbelevation\fR=\fIstring\fR]   [\fBtopidx\fR=\fIstring\fR]   [\fBnidxclass\fR=\fIinteger\fR]  \fBidxstats\fR=\fIstring\fR \fBparameters\fR=\fIstring\fR \fBinput\fR=\fIstring\fR \fBoutput\fR=\fIstring\fR  [\fBQobs\fR=\fIstring\fR]   [\fBtimestep\fR=\fIinteger\fR]   [\fBidxclass\fR=\fIinteger\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-i\fR" 4m
.br
Input data given for (o/i)
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBbasin\fR=\fIstring\fR" 4m
.br
(i)   Basin map created by r.water.outlet (MASK)
.IP "\fBelevation\fR=\fIstring\fR" 4m
.br
(i)   Elevation map
.IP "\fBdepressionless\fR=\fIstring\fR" 4m
.br
(o)   Depressionless elevation map
.IP "\fBdirection\fR=\fIstring\fR" 4m
.br
(o)   Direction map for depressionless elevation map
.IP "\fBbelevation\fR=\fIstring\fR" 4m
.br
(o/i) Basin elevation map (MASK applied)
.IP "\fBtopidx\fR=\fIstring\fR" 4m
.br
(o)   Topographic index ln(a/tanB) map (MASK applied)
.IP "\fBnidxclass\fR=\fIinteger\fR" 4m
.br
(i)   Number of topographic index classes
.br
Default: \fI30\fR
.IP "\fBidxstats\fR=\fIstring\fR" 4m
.br
(o/i) Topographic index statistics file
.IP "\fBparameters\fR=\fIstring\fR" 4m
.br
(i)   TOPMODEL Parameters file
.IP "\fBinput\fR=\fIstring\fR" 4m
.br
(i)   Rainfall and potential evapotranspiration data file
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
(o)   Output file
.IP "\fBQobs\fR=\fIstring\fR" 4m
.br
(i)   OPTIONAL Observed flow file
.IP "\fBtimestep\fR=\fIinteger\fR" 4m
.br
(i)   OPTIONAL Output for given time step
.IP "\fBidxclass\fR=\fIinteger\fR" 4m
.br
(i)   OPTIONAL Output for given topographic index class
.PP
.SH DESCRIPTION
\fB\fIr.topmodel\fR\fR simulates TOPMODEL which is a physically based
hydrologic model.
.PP
Note: (i) means input; (o) means output; (o/i) means input or output
.PP
The \fB-i\fR 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.
.PP
.SS Selected Parameters:
.IP "\fBdepressionless\fR map is created as follows:" 4m
\fC
.DS
.br
r.fill.dir input=elevation elev=depressionless dir=direction type=grass
.br
.DE
\fR
This option can be omitted if [elevation] map is already depressionless.
.PP
.IP "\fBbelevation\fR map is created from [elevation] with [basin] mask applied:" 4m
\fC
.DS
.br
r.mapcalc "belevation = if(basin == 0 || isnull(basin), null(), elevation)"
.br
.DE
\fR
.PP
.IP "\fBtopidx\fR map is created as follows:" 4m
\fC
.DS
.br
r.topidx input=elevation output=topidx
.br
.DE
\fR
.PP
.IP "\fBQobs\fR" 4m
.br
Compare simulated flows with observed flows and calculate model
efficiency.
.PP
.PP
.SH 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.
.PP
S.C. Liaw, Streamflow simulation using a physically based hydrologic
model in humid forested watersheds (Dissertation).
Colorado State University, CO. p163, 1988.
.SH SEE ALSO
\fI
r.fill.dir,
r.mapcalc,
r.topidx\fR
.br
How to run r.topmodel
.SH AUTHORS
Main algorithm sources are rewritten in C based on TMOD9502.FOR.
.br
Thanks to Keith Beven.
.PP
GRASS port by Huidae Cho
.br
Hydro Laboratory, Kyungpook National University, South Korea
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team