/RMODFLOW

Pre- and post-processing of MODFLOW files in R

Primary LanguageR

RMODFLOW
Pre- and post-processing of MODFLOW files in R

Travis-CI Build Status CRAN_Status_Badge Coverage Status

The RMODFLOW package provides a set of tools for groundwater flow modelling with MODFLOW. A related package is the RMT3DMS package for solute transport modelling.

To install

  1. install the devtools package: install.packages("devtools")
  2. install the latest development version: devtools::install_github("rogiersbart/RMODFLOW")

For users

The package is still in development, although different people have already made good use of it. This means that breaking changes might still happen more than you would like. Once we are close to a first major release (i.e. a first version on CRAN hopefully), this will of course not be the case anymore. A good place to start is the vignette "A brief overview".

For contributors

Using R and MODFLOW, and wanting to contribute? Please do so! The most straightforward contributions at the moment are in the form of file reading, writing and object creation functions for the many still-not-supported MODFLOW packages. I intend to create a vignette for contributors, listing what packages we are currently supporting etc., but it is not there yet. It is probably not too hard to find out yourself however. Just make sure you do things the way we do, and you follow the online guide to MODFLOW meticulously (note we use lowercase versions of all parameters here). A good starting point is probably to have a close look at rmf_read_dis() and the corresponding page in the online guide. Note also that we are first focussing on MODFLOW-2005 packages. Later on the other derived versions of MODFLOW-2005 might be supported as well. MODFLOW-2000 and MODFLOW 6 are out of scope.

What's next?

There are many ideas for further development. Here are a few to give you a taste of where this is going:

  • S3 methods for several htmlwidgets enabling interactive visualization.
  • Extend animation and 3D visualization support.
  • More compatibility with the tidyverse, possibly resulting in something like an RMODFLOW model manipulation language, which would allow to make use of e.g. dplyr verbs.
  • Functions for downloading different MODFLOW versions.
  • Support more MODFLOW packages
  • Add access to external, larger model examples.

References