Readme

Arnd Weber & Christopher Nicholls 2023-07-11

elbe1d

The package elbe1d is designed to analyze and correlate ecological, hydrological, hydraulic and geomorphological parameters related to riverbed incision along the free-flowing section of River Elbe in Germany.

get...()-functions enable highly parallelized querying of longitudinal floodplain and waterway properties along River Elbe. For 5850 individual cross-section areas along the rivers axis land use and ecological (e.g. getDLM(), getPNV()), hydrological and hydraulic (e.g. getSlope(), getDiffbetweenMNQMHQ(), getPbelowMQ()) and geomorphological (e.g. getDEMmin(), getRatio(), getAxisPDiff() variables can be queried. Usually, these get...()-functions are executed within intoDB(), which captures the individual results and inserts them into a central PostgreSQL database.

Finally, all queried parameters are analyzed and correlated along the rivers axis considering spatial autocorrelation using R INLA. To perform a full screening of all potential model candidates a modified version of INLAutils::INLAstep is provided.

Installation

The R package elbe1d is not currently available from CRAN, but you can install it from its github repository via:

devtools::install_github("bafg-bund/elbe1d")

Usage

The package elbe1d is built around the object sf.afe_csa of class sf and a digital elevation model (DEM) that describes the topography of the active floodplain of the River Elbe (Weber 2020). This DEM is divided in 49 tiles along the river and forms the basis of the intendet SLURM parallelization (slurm/). Each tile is subsetted by the selected, indexed polygon of the cross-section areas in sf.afe_csa and the corresponding value for the requested parameter is calculated and returned.

# load the package
library(elbe1d)

# use a query function
getDEMmax(3900)

## [1] 35.32

intoDB() can be used as wrapper to query a value and insert the result directly into the central database:

# query and insert the result into the database
intoDB(3900, "DEMmax")