r.avaframe.com1dfa_v2 - GRASS GIS manual

NAME

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

KEYWORDS

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

SYNOPSIS

r.avaframe.com1dfa_v2

r.avaframe.com1dfa_v2 --help

r.avaframe.com1dfa_v2 [-l] id=string url=string release_area_layer_id=string [entrainment_area_layer_id=string] [resistance_area_layer_id=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:

id=string [required]: Id of release area
url=string [required]: URL to the featureservice of the input data (release, entrainment and resistance area)
release_area_layer_id=string [required]: Layer ID for the release area on the feature service.
entrainment_area_layer_id=string: Layer ID for the entrainment area on the feature service.
resistance_area_layer_id=string: Layer ID for the resistance area on the feature service.
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; Default: 1

DESCRIPTION
- Entrainment area
- Resistance area
NOTES
REFERENCES
EXAMPLES
- Run com1DFA simulations for a release area registered in NVE database
SEE ALSO
AUTHOR

DESCRIPTION

r.avaframe.com1dfa_v2 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

frictModel frictionModel Friction models can be samosAT (1), Coulomb (2), Voellmy (2) or Wetsnow (3).

relTh multipleRelTh_m Release thicknesses in meter. Comma seperated string if you want to run the model several times with different inputs.

rho rho_kgPerCubicM Density of snow in kg/m³

cpIce cpIce_joulePerKg Ice in J/kg

TIni tIni_degreeCelcius Initial temperature in ⁰C

entTempRef entTemp_degreeCelcius Initial temperature for entrainment in ⁰C

enthRef enthalpy_joulePerKg Reference enthalpy in J/kg

com1DFA parameter name	Column name in attribute table	Parameter description
frictModel	frictionModel	Friction models can be samosAT (1), Coulomb (2), Voellmy (2) or Wetsnow (3).
relTh	multipleRelTh_m	Release thicknesses in meter. Comma seperated string if you want to run the model several times with different inputs.
rho	rho_kgPerCubicM	Density of snow in `kg`/`m`³
cpIce	cpIce_joulePerKg	Ice in `J`/`kg`
TIni	tIni_degreeCelcius	Initial temperature in ⁰`C`
entTempRef	entTemp_degreeCelcius	Initial temperature for entrainment in ⁰`C`
enthRef	enthalpy_joulePerKg	Reference enthalpy in `J`/`kg`

Entrainment area

An entrainment area can be used in the model. To do so, set the e-flag and provide an OGR readable vector data source for the entrainment_area

Parameters for the simulation need to be provided in the attribute table of the entrainment_area data source, according to the table below.

com1DFA parameter name Column name in attribute table Parameter description

rhoEnt rhoEnt_kgPerCubicM density of entrained snow in kg/m³

entEroEnergy entEro_joulePerKg Entrainment erosion energy in J/kg

entShearResistance entShear_joulePerSqM J/m²

entDefResistance entDef_joulePerKg J/kg

entTh entTh_m Entrainment thickness in meter

com1DFA parameter name	Column name in attribute table	Parameter description
rhoEnt	rhoEnt_kgPerCubicM	density of entrained snow in `kg`/`m`³
entEroEnergy	entEro_joulePerKg	Entrainment erosion energy in `J`/`kg`
entShearResistance	entShear_joulePerSqM	`J`/`m`²
entDefResistance	entDef_joulePerKg	`J`/`kg`
entTh	entTh_m	Entrainment thickness in `meter`

Resistance area

An resistance area can be used in the model. To do so, set the e-flag and provide an OGR readable vector data source for the resistance_area

Parameters for the simulation need to be provided in the attribute table of the resistance_area data source, according to the table below.

com1DFA parameter name Column name in attribute table Parameter description

hRes hRes_m Height of the obstacles in meter

cw cw Resistance coefficient [0-1]

dRes dRes_m Diameter of obstacles in meter

sres sRes_m Spacing between obstacles in meter

com1DFA parameter name	Column name in attribute table	Parameter description
hRes	hRes_m	Height of the obstacles in `meter`
cw	cw	Resistance coefficient [0-1]
dRes	dRes_m	Diameter of obstacles in `meter`
sres	sRes_m	Spacing between obstacles in `meter`

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.

r.avaframe.com1dfa_v2 --o -l elevation="DTM_10m@DTM" nprocs=8 format="csv" buffer=1500 \
    url="https://gis3.nve.no/arcgis/rest/services/featureservice/AlarmInput/FeatureServer" \
    release_area_layer_id="0" id="1" \
    ppr="ppr" pft="pft" pfv="pfv"

AUTHOR

Stefan Blumentrath and Yngve Antonsen

SOURCE CODE

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

Accessed: Monday Sep 16 09:38:05 2024