DassFlow2D-WRAP

This git repository contains the development version of DassFlow2D-Wrapped.

Table of Contents

1. General Information.
2. Repository organisation.
3. Requirements.
4. Install project.
5. Compile and open documentation.
6. First steps and more.

1. General information

WARNING: For the moment, dassflow2d and other versions work on Linux only.

You can clone this project to your own machine using the following command:

git clone http://github.com/DassHydro-dev/dassflow2d

Full and up-to-date documentation can be found in index.html. To open it, enter the following command in the terminal (in your repository directory):

open ./doc/SPHINX_DOCUMENTATION/build/html/index.html

2. Repository organisation

• Tools: contains scripts for pre and post processing of dassflow 2d wrap.
• cases: contains reference cases.
• code: contains source code & the bin directory where the simulations happen.
• doc: contains SPHINX documentation (See Compile and open documentation for more information).

3. Requirements

3.1 For dassflow2d installation

Note: some of the modules below might already be installed on your Linux machine.

3.1.1 For the Fortran code

• python 3.8 or above (check your python version with python3 --version in the terminal)
• an up-to-date Java Development Kit (JDK) (check your java version with java --version in the terminal or install it with sudo apt install default-jdk)
• an MPI library : mpich

sudo apt install -y mpich

• Follow the tutorial to download and install Tapenade and add the following lines to your ~/.bashrc to add tapenade to your PATH:

alias tapenade="tapenade_dir/bin/tapenade"
TAPENADE_HOME=tapenade_dir/bin
export PATH=$PATH:$TAPENADE_HOME
export PATH=$PATH:$"tapenade_dir"

Note: tapenade_dir is the absolute path to the directory containing the tapenade files you just downloaded.

3.1.2 For the Python wrapped code

• pip3
• f90wrap

  pip install f90wrap

Add f90wrap to your PATH in ~/.bashrc. For example:

F90WRAP_HOME=~/.local/bin
export PATH=$PATH:$F90WRAP_HOME

Note: don't forget to enter the command source ~/.bashrc to reload your .bashrc after modifying it.

3.2 For SPHINX documentation compilation

In your terminal, execute the following commands:

pip install -U Sphinx
pip install numpydoc
pip install pydata_sphinx_theme
pip install sphinx-panels
pip install IPython
pip install sphinxcontrib-bibtex
pip install jupyter_sphinx
python3 -m pip install sphinx-autosummary-accessors

4. Install project

• Make sure all the requirements are met.
• Execute the following commands in the terminal (in your repository directory):

cd ./code
make install

Note: project installation has default parameters that you can change in Makefile.inc before installation.

5. Compile and open documentation

1. Make sure all the requirements are met.
2. Make sure the project has correctly been installed (see Install Project).
3. Execute the following commands in the terminal (in your repository directory):

cd ./doc/SPHINX_DOCUMENTATION/
make clean html

6. First steps and more

Please refer to the SPHINX documentation for more information, simple test cases and further details.

You can visit our website for more information on dassflow2d and other versions.