r.avaflow - GRASS manual

NAME

r.avaflow - The mass flow simulation tool

KEYWORDS

SYNOPSIS

r.avaflow

r.avaflow --help

r.avaflow [-aekmtv] [prefix=string] [cores=string] [cellsize=string] [phases=string[,string,...]] [gravity=string] [limiter=string] [layers=string] [controls=string[,string,...]] [aoicoords=string[,string,...]] [elevation=string] [hrelease=string] [rhrelease1=string[,string,...]] [vhrelease=string[,string,...]] [hrelease1=string] [hrelease2=string] [hrelease3=string] [trelease=string] [trelstop=string] [tslide=string] [tstop=string] [vinx=string] [viny=string] [vinx1=string] [viny1=string] [vinx2=string] [viny2=string] [vinx3=string] [viny3=string] [hentrmax=string] [rhentrmax1=string] [vhentrmax=string[,string,...]] [hentrmax1=string] [hentrmax2=string] [hentrmax3=string] [density=string[,string,...]] [friction=string[,string,...]] [viscosity=string[,string,...]] [basal=string[,string,...]] [transformation=string[,string,...]] [dynfric=string[,string,...]] [slidepar=string[,string,...]] [special=string[,string,...]] [phi1=string] [phi2=string] [phi3=string] [delta1=string] [delta2=string] [delta3=string] [tufri=string] [ny1=string] [ny2=string] [ny3=string] [ambdrag=string] [flufri=string] [centr=string] [cvshear=string] [deltab=string] [ctrans12=string] [ctrans13=string] [ctrans23=string] [zones=string] [impactarea=string] [hdeposit=string] [hydrograph=string[,string,...]] [hydrocoords=string[,string,...]] [adaptograph=string] [frictiograph=string] [transformograph=string] [sampling=string] [cfl=string[,string,...]] [time=string[,string,...]] [slomo=string] [thresholds=string[,string,...]] [profile=string[,string,...]] [ctrlpoints=string[,string,...]] [reftime=string[,string,...]] [phexagg=string] [orthophoto=string] [visualization=string[,string,...]] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a: Map plots of pressure and kinetic energy
-e: Model execution
-k: Keep result GRASS raster maps
-m: Multiple model runs
-t: Map plots of impact wave or tsunami height
-v: Evaluation and visualization
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

prefix=string: Prefix for output files and folders
cores=string: Number of cores to be used for multiple model runs
cellsize=string: Cell size in metres
phases=string[,string,...]: Phase(s) to be considered (maximum 3, comma-separated, x = mixture, s = solid, fs = fine solid, f = fluid, m = multi-phase)
gravity=string: Gravity (m/s2)
limiter=string: Numerical limiter (1 = Minmod limiter, 2 = Superbee limiter, 3 = Woodward limiter, 4 = van Leer limiter)
layers=string: Layer mode (0 = no, 1 = yes)
controls=string[,string,...]: Controls (comma-separated)
aoicoords=string[,string,...]: Set of coordinates delineating area of interest (N,S,E,W)
elevation=string: Name of elevation raster map
hrelease=string: Name of release height raster map
rhrelease1=string[,string,...]: Ratio(s) of PHASE 1 release height (comma-separated)
vhrelease=string[,string,...]: Variation of release height (comma-separated)
hrelease1=string: Name of PHASE 1 release height raster map
hrelease2=string: Name of PHASE 2 release height raster map
hrelease3=string: Name of PHASE 3 release height raster map
trelease=string: Release time raster map
trelstop=string: Release hydrograph stop time raster map
tslide=string: Time of initial sliding raster map
tstop=string: Stopping time raster map
vinx=string: Name of release velocity in x direction raster map
viny=string: Name of release velocity in y direction raster map
vinx1=string: Name of PHASE 1 release velocity in x direction raster map
viny1=string: Name of PHASE 1 release velocity in y direction raster map
vinx2=string: Name of PHASE 2 release velocity in x direction raster map
viny2=string: Name of PHASE 2 release velocity in y direction raster map
vinx3=string: Name of PHASE 3 release velocity in x direction raster map
viny3=string: Name of PHASE 3 release velocity in y direction raster map
hentrmax=string: Name of maximum height of entrainment raster map (comma-separated)
rhentrmax1=string: Ratio(s) of maximum height of PHASE 1 entrainment (comma-separated)
vhentrmax=string[,string,...]: Variation of maximum height of entrainment (comma-separated)
hentrmax1=string: Name of maximum height of PHASE 1 entrainment raster map
hentrmax2=string: Name of maximum height of PHASE 2 entrainment raster map
hentrmax3=string: Name of maximum height of PHASE 3 entrainment raster map
density=string[,string,...]: Density parameters (comma-separated)
friction=string[,string,...]: Friction parameters (comma-separated)
viscosity=string[,string,...]: Viscosity parameters (comma-separated)
basal=string[,string,...]: Basal surface parameters (comma-separated)
transformation=string[,string,...]: Phase transformation parameters (comma-separated)
dynfric=string[,string,...]: Parameters for the dynamic adaptation of friction (comma-separated)
slidepar=string[,string,...]: Parameters for initial sliding (search radius, exponent for weighting, coefficient for deformation)
special=string[,string,...]: Special parameters (comma-separated)
phi1=string: Name of internal friction angle of PHASE 1 raster map
phi2=string: Name of internal friction angle of PHASE 2 raster map
phi3=string: Name of internal friction angle of PHASE 3 raster map
delta1=string: Name of basal friction angle of PHASE 1 raster map
delta2=string: Name of basal friction angle of PHASE 2 raster map
delta3=string: Name of basal friction angle of PHASE 3 raster map
tufri=string: Name of turbulent friction coefficient raster map
ny1=string: Name of viscosity of PHASE 1 raster map
ny2=string: Name of viscosity of PHASE 2 raster map
ny3=string: Name of viscosity of PHASE 3 raster map
ambdrag=string: Name of ambient drag coefficient raster map
flufri=string: Name of fluid friction coefficient raster map
centr=string: Name of entrainment coefficient raster map
cvshear=string: Name of shear velocity coefficient raster map
deltab=string: Name of basal friction difference raster map
ctrans12=string: Name of PHASE 1-PHASE 2 transformation coefficient raster map
ctrans13=string: Name of PHASE 1-PHASE 3 transformation coefficient raster map
ctrans23=string: Name of PHASE 2-PHASE 3 transformation coefficient raster map
zones=string: Zones raster map
impactarea=string: Name of observed impact area raster map
hdeposit=string: Name of observed deposit height raster map
hydrograph=string[,string,...]: Path(es) to hydrograph file(s)
hydrocoords=string[,string,...]: Pairs of coordinates of hydrograph(s) (x1, y1, x2, y2, ...)
adaptograph=string: Path(es) to adaptograph file(s)
frictiograph=string: Path(es) to frictiograph file(s)
transformograph=string: Path(es) to transformograph file(s)
sampling=string: Type of parameter sampling (positive number = random, 0 = controlled, negative number = OAT)
cfl=string[,string,...]: CFL criterion, initial time step length (s)
time=string[,string,...]: Time interval (s), stop for writing output (s)
slomo=string: Factor for slow motion
thresholds=string[,string,...]: Lower thresholds for display of flow height, kinetic energy and pressure (comma-separated)
profile=string[,string,...]: Pairs of coordinates for profile plots (x1,y1,x2,y2,...)
ctrlpoints=string[,string,...]: Pairs of coordinates for control points (x1,y1,x2,y2,...)
reftime=string[,string,...]: Reference time of reach for each control point (t1,t2,...)
phexagg=string: Exaggeration of flow height in profile plots
orthophoto=string: Path to orthophoto tiff image
visualization=string[,string,...]: Parameters for visualization

DESCRIPTION
SEE ALSO
AUTHORS

DESCRIPTION

r.avaflow represents a GIS-supported open source software tool for the simulation of complex, cascading mass flows over arbitrary topography. It empoys the NOC-TVD numerical scheme (Wang et al., 2004) along with a Voellmy-type model, or with an enhanced version of the Pudasaini multi-phase flow model (Pudasaini and Mergili, 2019). Complementary functions include entrainment, deposition, stopping, and phase transformations. The starting mass may be defined through raster maps and/or hydrographs. r.avaflow includes the possibility to explore multi-core computing environments to run multiple simulations at once as a basis for parameter sensitivity analysis and optimization.

AUTHORS

Martin Mergili, University of Graz, Austria and Shiva P. Pudasaini, University of Bonn, Germany

The support of Massimiliano Alvioli, Matthias Benedikt, Emmanuel Delage, Wolfgang Fellin, Jan-Thomas Fischer, Sigridur S. Gylfadottir, Andreas Huber, Ivan Marchesini, Markus Metz, Markus Neteler, Alexander Ostermann, and Matthias Rauter is acknowledged.

Funding 2014-2017: German Research Foundation DFG and Austrian Research Fund FWF

© 2008-2022 The authors, © 2020-2022 The University of Graz, © 2010-2021 The BOKU University, Vienna, © 2015-2020 The University of Vienna, © 2014-2022 The University of Bonn, © 1999-2022 The GRASS Development Team and © 1993-2022 The R Development Core Team

SOURCE CODE

Available at: r.avaflow source code (history)

Accessed: Monday Jul 27 12:21:58 2026