GRASS logo

NAME

r.avaframe.com1dfa - Run com1dfa avalanche simulations using AvaFrame

KEYWORDS

avalanche, simulation, avaframe, com1dfa, raster, terrain, dtm

SYNOPSIS

r.avaframe.com1dfa
r.avaframe.com1dfa --help
r.avaframe.com1dfa [-l] release_area=string elevation=name [buffer=integer] [export_directory=name] [ppr=string] [pft=string] [pfv=string] [format=string] [nprocs=integer] [--help] [--verbose] [--quiet] [--ui]

Flags:

-l
Link temporary results (do not import)
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

release_area=string [required]
Path or URL to OGR readable vector dataset with release area(s)
elevation=name [required]
Name of input elevation raster map
buffer=integer
Buffer around release area for area of interest
Default: 2000
export_directory=name
Directory where resulting raster maps should be stored as GeoTiff
ppr=string
Name of the output imagery group for ppr
pft=string
Name of the output imagery group for pft
pfv=string
Name of the output imagery group for pfv
format=string
Format for output of simulation report to stdout
Options: csv, json
nprocs=integer
Number of threads for parallel computing
0: use OpenMP default; >0: use nprocs; <0: use MAX-nprocs
Default: 0

Table of contents

DESCRIPTION

r.avaframe.com1dfa runs Dense flow avalanche kernel (com1DFA) simulations using the Open Avalanche Framework AvaFrame.

Requred input are an OGR readable vector data source for the release_area, and a Digital Elevation Model elevation.

Parameters for the simulation need to be provided in the attribute table of the release_area data source, according to the table below. Currently, the following parameters for com1DFA simulations are supported:
com1DFA parameter name Column name in attribute table Parameter description
relTh snowDepth_cm Release thickness
rho rho_kgPerSqM Density of snow in kg/m3
rhoEnt rhoEnt_kgPerSqM Density of entrained snow in kg/m3
frictModel frictModel Friction models can be samosAT (1), Coulomb (2), and Voellmy (2)
The ASCII-raster files resulting from the AvaFrame simulations are either linked to the current mapset (if the l-flag is set), otherwise they ar imported into the GRASS GIS database.

An imagery group is created where thickness levels are stored as bands.

NOTES

This module sets the computational region to the release area with a user-defined buffer around, aligned to the input elevation model.

It assumes that the projection of the input OGR data source matches with the projection of the current location.

Parallel processing is supported, depending on the number of specified parallel processes (nprocs) and the number of realse thickness values to simulate for.

REFERENCES

com1DFA DFA-Kernel theory
com1DFA DFA-Kernel numerics
AvaFrame: Version 1.3 on Zenodo

EXAMPLES

Run com1DFA simulations for a release area registered in NVE database

r.avaframe.com1dfa --o -l elevation="DTM_10m@DTM" nprocs=8 format="csv" buffer=1500 \
    release_area="https://gis3.nve.no/arcgis/rest/services/featureservice/AlarmSamosAT/MapServer/0/query?where=objectid+%3D+1&outFields=*&f=json" \
    ppr="ppr" pft="pft" pfv="pfv"

SEE ALSO

r.external, i.group,

AUTHOR

Stefan Blumentrath

SOURCE CODE

Available at: r.avaframe.com1dfa source code (history)

Accessed: Monday Jul 27 12:28:08 2026

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

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual