Provides an R6 class and several utility methods to facilitate the implementation of models based on ordinary differential equations. The heart of the package is a code generator that creates compiled 'Fortran' (or 'R') code which can be passed to a numerical solver. There is direct support for solvers contained in packages 'deSolve' and 'rootSolve'.
rodeo is an add-on package for the
R statistical computing software. It facilitates the implementation of mechanistic models built on ordinary differential equations (ODE).
rodeo imposes a well-known standard notation for simultaneous ODE based on the stoichiometry matrix. This notation is widely used in chemical and wastewater engineering or biogeoscience.
rodeo separates the conceptual model (the set of ODE) from its implementation (computer program) by means of automatic code generation. This makes models more easy (1) to understand by non-programmers, (2) to run on different platforms/environments, (3) to develop or modify, and (4) to 'archive' in times of rapidly changing software.
The generated code (Fortran, R) can be used with existing suites of numerical solvers, namely the R-packages
deSolve for dynamic simulation and
rootSolve for steady-state estimation. The use of compiled Fortran speeds up numerical integration significantly compared to a purely R-based model implementation (often by a factor between 2 and 100).
rodeo has with built-in support for 1-D partial differential equations (PDE) being tackled with the numerical method-of-lines.
The package currently provides a single R6 class named just like the package (
rodeo). It contains several class- and non-class methods to
The package vignette provides further details.
A current installation of R is required. In order to work with
rodeo in high-performance mode, one needs the tools to compile Fortran 2008 code (compiler, make utilities, etc.). These tools are typically available by default on Linux systems. Users of other systems should have a look at the Rtools.
The development version of the package can be installed directly from the github repository as shown below. For this, the
devtools package is required.
library("devtools") install_github("dkneis/rodeo") library("rodeo")
The release version should be available on CRAN and can be installed as usual (see below). Note that the release version may lag behind the development version in terms of functionality.
# Install and load release version install.packages("rodeo") library("rodeo")