Skip to content

r.basins.fill

Generates watershed subbasins raster map.

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

Example:

r.basins.fill cnetwork=name tnetwork=name output=name number=integer

grass.script.run_command("r.basins.fill", cnetwork, tnetwork, output, number, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.basins.fill", cnetwork="name", tnetwork="name", output="name", number=integer)

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
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

cnetwork : str, required
    Name of input coded stream network raster map
    Used as: input, raster, name
tnetwork : str, required
    Name of input thinned ridge network raster map
    Used as: input, raster, name
output : str, required
    Name for output raster map
    Used as: output, raster, name
number : int, required
    Number of passes through the dataset
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

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

SOURCE CODE

Available at: r.basins.fill source code (history)
Latest change: Tuesday Mar 04 21:25:20 2025 in commit 9227329