r.stream.watersheds

Sub-watershed and sub-stream delineation based on the drainage direction and a gridded stream network.

r.stream.watersheds drainage=name stream=name [folder=name] [cpu=float] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.stream.watersheds drainage=name stream=name

grass.script.run_command("r.stream.watersheds", drainage, stream, folder="GISDBASE/folder_structure", cpu=1, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.stream.watersheds", drainage="name", stream="name")

Parameters

Command linePython (grass.script)

drainage=name [required]
    Name of the drainage direction raster (generated with r.watershed)
stream=name [required]
    Name of the stream network raster
folder=name
    Provide the full folder path and name where the sub-watersheds and sub-streams should be stored
    Default: GISDBASE/folder_structure
cpu=float
    Number of CPUs used for the parallel computation
    Default: 1
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

drainage : str, required
    Name of the drainage direction raster (generated with r.watershed)
    Used as: name
stream : str, required
    Name of the stream network raster
    Used as: name
folder : str, optional
    Provide the full folder path and name where the sub-watersheds and sub-streams should be stored
    Used as: name
    Default: GISDBASE/folder_structure
cpu : float, optional
    Number of CPUs used for the parallel computation
    Default: 1
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

Delineate the upstream contributing area ('sub-watershed') and stream sections ('sub-stream') for each grid cell of a stream network.

REFERENCES

Sami Domisch, Giuseppe Amatulli, Walter Jetz (2015): Near-global freshwater-specific environmental variables for biodiversity analyses in 1 km resolution, Scientific Data 2, 150073, DOI:10.1038/sdata.2015.73

AUTHORS

Giuseppe Amatulli
Sami Domisch

SOURCE CODE

Available at: r.stream.watersheds source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819