.TH r.basins.fill 1 "" "GRASS 6.3.0" "Grass User's Manual"
.SH NAME
\fI\fBr.basins.fill\fR\fR  - Generates a raster map layer showing watershed subbasins.
.SH KEYWORDS
raster
.SH SYNOPSIS
\fBr.basins.fill\fR
.br
\fBr.basins.fill help\fR
.br
\fBr.basins.fill number\fR=\fIinteger\fR \fBc_map\fR=\fIstring\fR \fBt_map\fR=\fIstring\fR \fBresult\fR=\fIstring\fR  [--\fBoverwrite\fR]  [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Flags:
.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 "\fBnumber\fR=\fIinteger\fR" 4m
.br
Number of passes through the dataset
.IP "\fBc_map\fR=\fIstring\fR" 4m
.br
Coded stream network file name
.IP "\fBt_map\fR=\fIstring\fR" 4m
.br
Thinned ridge network file name
.IP "\fBresult\fR=\fIstring\fR" 4m
.br
Name for the resultant watershed partition file
.PP
.SH DESCRIPTION
\fIr.basins.fill\fR
generates a raster map layer depicting subbasins, based 
on input raster map layers for the coded stream network 
(where each channel segment has been "coded" with a unique category value) 
and for the ridges within a given watershed. 
The raster map layer depicting ridges should include 
the ridge which defines the perimeter of the watershed. 
The coded stream network can be generated 
as part of the 
\fIr.watershed\fR program, 
but the map layer of ridges will need to be created by hand
(for example, through digitizing done in \fIv.digit\fR).
.PP
The resulting output raster map layer will 
code the subbasins with category values matching 
those of the channel segments passing through them. 
A user-supplied number of passes through the data is 
made in an attempt to fill in these subbasins. 
If the resulting map layer from this program appears to 
have holes within a subbasin, the program should be 
rerun with a higher number of passes. 
.br
.SH NOTES
The current geographic region setting is ignored. 
Instead, the geographic region for the entire input stream's 
map layer is used. 
.SH SEE ALSO
See Appendix A of the \fBGRASS\fR <a
href="http://grass.itc.it/gdp/raster/r.watershed.ps">Tutorial:
r.watershed for further details on the combined use of
\fIr.basins.fill\fR and \fIr.watershed\fR.
.PP
\fIr.watershed\fR,
\fIv.digit\fR
.SH AUTHORS
Dale White, 
Dept. of Geography, 
Pennsylvania State University
.br
Larry Band, Dept. of Geography, University of Toronto, Canada 
.PP
\fILast changed: $Date: 2008-01-25 19:42:36 +0100 (Fri, 25 Jan 2008) $\fR
.PP
Full index
.PP
© 2003-2008 GRASS Development Team