A Meta-Package Integrating Several Hydrological Model Packages in R.
An R meta-package of lumped conceptual models was developed based on the review of R-packages and the therein stated aim “[…] to run all the packages through the same R architecture” (Astagneau et al., 2021). So far the models are restricted to daily input. It was called openQUARREL (QUantifying And Reducing uncertainties with an R package providing an Ensemble of hydrological modeLs) and combines hydrological model packages, applies several calibration routines and offers evaluation tools.
It heavily relies on external packages as airGR, hydromad, TUWmodel (HBV) and topmodel with their hydrological models. Similarly, for calibration external packages are integrated as DEoptim, hydroPSO and others. For objective functions it uses the hydroGOF package, and applies the great plots of airGR to models of other packages.
The multimodel is operationally in use for monthly drought forecasting since September 2023. Current results are available under https://www.drought.ch/de/prognosen/hydrologisches-multimodell/ (description in German only).
Installation
Currently, it is dependent on airGR version 1.6.12 and hydromad 0.9-26. The author is currently contacting the developers to also being able to include their newest versions. The hydromad package is automatically installed from their github folder using the oldstable branch. The airGR package version 1.6.12 needs to be installed from CRAN archive like this, previously to the installation of openQUARREL:
install.packages("https://cran.r-project.org/src/contrib/Archive/airGR/airGR_1.6.12.tar.gz", repos = NULL, type = "source")Similarly, topmodel was recently removed from CRAN and can be installed like so:
install.packages("https://cran.r-project.org/src/contrib/Archive/topmodel/topmodel_0.7.5.tar.gz", repos = NULL, type = "source")Now you can install openQUARREL.
Note: Choose “3: None” after the prompt to not update your packages after this command as this will also update airGR (on CRAN) and hydromad (on github).
remotes::install_github("mw-schirmer/openQUARREL", dependencies = TRUE)Example
This is a basic example which shows you how to run some hydrological models vignette("run_model_minimalistic").
Code availability
The code is available to download under https://github.com/mw-schirmer/openQUARREL.
Your contribution
If you want your model to be included I simply need a code snippet as for example done in the assets of (Astagneau et al., 2021). Here they provided an example on how to prepare data and run a model with the TUWmodel package.