The Routing Application for Parallel computatIon of Discharge (RAPID) is a river network routing model. Given surface and groundwater inflow to rivers, this model can compute flow and volume of water everywhere in river networks made out of many thousands of reaches.
For further information on RAPID including peer-reviewed publications, tutorials, sample input/output data, sample processing scripts and animations of model results, please go to: http://rapid-hub.org/.
Installing RAPID is by far the easiest with Docker. This document was written and tested using Docker Community Edition which is available for free and can be installed on a wide variety of operating systems. To install it, follow the instructions in the link provided above.
Note that the experienced users may find more up-to-date installation instructions in Dockerfile.
Downloading RAPID with Docker can be done using:
$ docker pull chdavid/rapid
The beauty of Docker is that there is no need to install anymore packages. RAPID is ready to go! To run it, just use:
$ docker run --rm --name rapid -it chdavid/rapid
Testing scripts are currently under development.
Note that the experienced users may find more up-to-date testing instructions in docker.test.yml.
This document was written and tested on a machine with a clean image of Ubuntu 18.04.6 Desktop 64-bit installed, i.e. no update was performed, and no upgrade either.
Note that the experienced users may find more up-to-date installation instructions in github_actions_CI.yml.
First, make sure that git
is installed:
$ sudo apt-get install -y --no-install-recommends git
Then download RAPID:
$ git clone https://github.com/c-h-david/rapid
Finally, enter the rapid directory:
$ cd rapid/
Software packages for the Advanced Packaging Tool (APT) are summarized in
requirements.apt
and can be installed with apt-get
. All packages can be installed at once using:
$ sudo apt-get install -y --no-install-recommends $(grep -v -E '(^#|^$)' requirements.apt)
Alternatively, one may install the APT packages listed in requirements.apt one by one, for example:
$ sudo apt-get install -y --no-install-recommends gfortran
The Network Common Data Form (NetCDF) can be installed using:
$ mkdir $HOME/installz
$ cd $HOME/installz
$ mkdir netcdf-install
$ wget -O netcdf-c-4.7.3.tar.gz https://github.com/Unidata/netcdf-c/archive/refs/tags/v4.7.3.tar.gz
$ wget -O netcdf-fortran-4.5.2.tar.gz https://github.com/Unidata/netcdf-fortran/archive/refs/tags/v4.5.2.tar.gz
$ tar -xzf netcdf-c-4.7.3.tar.gz
$ tar -xzf netcdf-fortran-4.5.2.tar.gz
$ cd netcdf-c-4.7.3/
$ ./configure CC=gcc CPPFLAGS=-I/usr/lib/x86_64-linux-gnu/hdf5/serial/include LDFLAGS=-L/usr/lib/x86_64-linux-gnu/hdf5/serial/lib --prefix=$HOME/installz/netcdf-install --disable-dap
$ make check > check.log
$ make install > install.log
$ cd ..
$ cd netcdf-fortran-4.5.2/
$ ./configure CC=gcc FC=gfortran LD_LIBRARY_PATH=$HOME/installz/netcdf-install/lib:$LD_LIBRARY_PATH CPPFLAGS=-I$HOME/installz/netcdf-install/include LDFLAGS=-L$HOME/installz/netcdf-install/lib --prefix=$HOME/installz/netcdf-install/
$ make check > check.log
$ make install > install.log
$ cd ..
Then, the environment should be updated using:
$ export TACC_NETCDF_DIR=$HOME/installz/netcdf-install
$ export TACC_NETCDF_LIB=$TACC_NETCDF_DIR/lib
$ export TACC_NETCDF_INC=$TACC_NETCDF_DIR/include
$ export LD_LIBRARY_PATH=$TACC_NETCDF_LIB
$ export PATH=$PATH:$TACC_NETCDF_DIR/bin
Note that these four lines can also be added in
~/.bash_aliases
so that the environment variables persist.
The Portable, Extensible Toolkit for Scientific Computation (PETSc) can be installed using:
$ cd $HOME/installz
$ wget "http://ftp.mcs.anl.gov/pub/petsc/release-snapshots/petsc-3.13.0.tar.gz"
$ tar -xzf petsc-3.13.0.tar.gz
$ cd petsc-3.13.0
$ ./configure PETSC_DIR=$PWD PETSC_ARCH=linux-gcc-c --download-fblaslapack=1 --download-mpich=1 --with-cc=gcc --with-cxx=g++ --with-fc=gfortran --with-clanguage=c --with-debugging=0
$ make PETSC_DIR=$PWD PETSC_ARCH=linux-gcc-c all > all.log
$ make PETSC_DIR=$PWD PETSC_ARCH=linux-gcc-c check > check.log
Then, the environment should be updated using:
$ export PETSC_DIR=$HOME/installz/petsc-3.13.0
$ export PETSC_ARCH=linux-gcc-c
$ export PATH=$PATH:$PETSC_DIR/$PETSC_ARCH/bin
Note that these three lines can also be added in
~/.bash_aliases
so that the environment variables persist.
$ cd rapid/
$ cd src/
$ make rapid
Testing scripts are currently under development.
$ cd rapid/
$ cd tst/
$ gfortran -o tst_run_comp tst_run_comp.f90 -I $TACC_NETCDF_INC -L $TACC_NETCDF_LIB -lnetcdff
$ gfortran -o tst_run_cerr tst_run_cerr.f90 -I $TACC_NETCDF_INC -L $TACC_NETCDF_LIB -lnetcdff
$ gfortran -o tst_run_conv_Qinit tst_run_conv_Qinit.f90 -I $TACC_NETCDF_INC -L $TACC_NETCDF_LIB -lnetcdff
Note that the experienced users may find more up-to-date testing instructions in github_actions_CI.yml.