GRASS logo

NAME

r.slopeunits.optimize - Optimize inputs for slope units

KEYWORDS

raster, elevation, slopeunits

SYNOPSIS

r.slopeunits.optimize
r.slopeunits.optimize --help
r.slopeunits.optimize [-s] demmap=name [plainsmap=name] basin=name slumap=name [slumapclean=name] thresh=float rf=integer maxiteration=integer cleansize=float cvmin=min,max areamin=min,max epsilonx=float epsilony=float outdir=name [convergence=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-s
SFD (D8) flow in r.watershed (default is MFD)
SFD: single flow direction, MFD: multiple flow direction
--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:

demmap=name [required]
Input digital elevation model
plainsmap=name
Input raster map of alluvial plains
basin=name [required]
Name of input vector map
Input basin passed to r.slopeunits.metrics
slumap=name [required]
Slope Units layer (the main output of r.slopeunits.create)
Default: su_tmp
slumapclean=name
Slope Units layer, cleaned (the main output of r.slopeunits.clean)
Default: su_tmp_cl
thresh=float [required]
Initial threshold (m^2)
rf=integer [required]
Factor used to iterativelly reduce initial threshold
maxiteration=integer [required]
maximum number of iteration to do before stopped
cleansize=float [required]
Slope Units size to be removed
Default: 25000
cvmin=min,max [required]
Start search with these initial minimum and maximum values of the circular variance (0.0-1.0) below which the slope unit is not further segmented
Default: 0.05,0.25
areamin=min,max [required]
Start search with these initial minimum and maximum values of the area (m^2) below which the slope unit is not further segmented
Default: 50000.0,200000.0
epsilonx=float [required]
Stop loop when difference of cvmin limits is lesser than this value
Default: 0.01
epsilony=float [required]
Stop loop when difference of areamin limits is lesser than this value
Default: 50000
outdir=name [required]
Output directory for intermediate results for all cvmin and areamin values and final results. Default folder "outdir" in current working directory.
Default: outdir
convergence=integer
Convergence factor for MFD in r.watershed (1-10)
1 = most diverging flow, 10 = most converging flow. Recommended: 5
Default: 5

Table of contents

DESCRIPTION

r.slopeunits.optimize determines optimal input values for slope units: It calls r.slopeunits.create, r.slopeunits.clean and r.slopeunits.metrics iteratively. Output is a file opt.txt with optimal values in either specified folder or in folder output/" in the current working directory. Also files calcd.dat and current.txt are created with all determined and examined values and the four latest examined values (combination of areamin and cvmin minimum and maximum) and center respectively.

NOTES

EXAMPLE

r.slopeunits.optimize \
    basin=basin_chk \
    demmap=dem_italia_isolegrandi@su_test \
    plainsmap=flat \
    thresh=250000 \
    rf=2 \
    maxiteration=50 \
    cleansize=25000

SEE ALSO

r.slopeunits.create, r.slopeunits.clean, r.slopeunits.metrics

AUTHORS

Main authors: Ivan Marchesini, Massimiliano Alvioli, CNR-IRPI
Carmen Tawalika (translation to python, refactoring), mundialis

SOURCE CODE

Available at: r.slopeunits.optimize source code (history)

Latest change: Wednesday Jan 22 09:08:05 2025 in commit: 716d827ce825ef48b41cedc17e8801b5973bd05c

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.5.0dev Reference Manual