NAME

       r.basins.fill  - Generates watershed subbasins raster map.

KEYWORDS

       raster, hydrology, watershed

SYNOPSIS

       r.basins.fill
       r.basins.fill --help
       r.basins.fill   cnetwork=name   tnetwork=name  output=name  number=integer   [--overwrite]
       [--help]  [--verbose]  [--quiet]  [--ui]

   Flags:
       --overwrite
           Allow output files to overwrite existing files

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       cnetwork=name [required]
           Name of input coded stream network raster map

       tnetwork=name [required]
           Name of input thinned ridge network raster map

       output=name [required]
           Name for output raster map

       number=integer [required]
           Number of passes through the dataset

DESCRIPTION

       r.basins.fill 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 r.watershed program, but the  map
       layer  of  ridges will need to be created by hand (for example, through digitizing done in
       wxGUI vector digitizer).

       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.

NOTES

       The current geographic region setting is ignored.  Instead, the geographic region for  the
       entire input stream’s map layer is used.

SEE ALSO

       See  Appendix A of the GRASS Tutorial: r.watershed for further details on the combined use
       of r.basins.fill and r.watershed.

        r.water.outlet, r.watershed, wxGUI vector digitizer

AUTHORS

       Dale White, Dept. of Geography, Pennsylvania State University
       Larry Band, Dept. of Geography, University of Toronto, Canada

       Last changed: $Date: 2014-04-11 17:48:44 +0200 (Fri, 11 Apr 2014) $

       Main index | Raster index | Topics index | Keywords index | Full index

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual