
DuMux course material
The material is organized as follows
- Exercises: click here to go to the exercise description
- Slides: click here to view the slide overview
- Links: click here to go to a list of useful links
Installation of the course
Before undertaking the course, please be sure to check on the expected prerequisites. To get started with the course, you have two options. Depending on whether you already have DuMux installed or not, choose the one that fits your needs. If you plan to use Ubuntu on Windows via WSL, we have a brief installation documentation for the installation of dumux.
Install DuMux together with the course
The easiest way to install everything you need is to use the install script installcourse.sh
.
The script will install all needed ubuntu-packages, clone the required git repositories and build the dumux-course.
It is also recommended to have a look inside the script, for further understanding.
Open a terminal (inside Ubuntu) and use the following commands:
wget https://git.iws.uni-stuttgart.de/dumux-repositories/dumux-course/-/raw/master/installcourse.sh
bash installcourse.sh
If you don't have wget
and don't want to install it, you can just manually download the
installcourse.sh
script from the git repository.
In case you encounter an error, have a look at the Troubleshooting section.
Install the course into your existing DuMux project
If you already have an installation of DuMux, navigate to your DuMux root directory and then run the following commands:
python3 dumux/bin/installexternal.py dumux-course
./dune-common/bin/dunecontrol --opts=./dumux/cmake.opts --only=dumux-course all
This will download and then configure the course repository using dunecontrol
.
If there is an error with the build setup try deleting the CMake cache and reconfigure by running
./dune-common/bin/dunecontrol bexec rm -r CMakeFiles CMakeCache.txt
./dune-common/bin/dunecontrol --opts=./dumux/cmake.opts all
After this, you can start with the exercises.
Requirements
For a successful installation and the execution of all exercises, the following software packages are needed:
- gcc >= 9.3
- cmake >= 3.14
- git
- pkg-config
- paraview (to visualize the results)
- gnuplot (to plot some curves)
- wget (to download some config files during the installation)
For some excercises you might need UMFPack. UMFPack can be installed via Suitesparse.
For instance on Ubuntu use apt-get install libsuitesparse-dev
.
Troubleshooting
If the installcourse.sh
script fails, the terminal output can be found in installcourse.log
.
On a recent mac with silicon chip you may get an error similar to clang: error: the clang compiler does not support '-march=native'
.
In this case copy configure options file cmake.opts by running
cd dumux
cp dumux/cmake.opts mycmake.opts
In mycmake.opts
delete the line containing -march=native \
. Rerun dunecontrol
using mycmake.opts
:
./dune-common/bin/dunecontrol bexec rm -r CMakeFiles CMakeCache.txt
./dune-common/bin/dunecontrol --opts=mycmake.opts configure
./dune-common/bin/dunecontrol --opts=mycmake.opts make -j
If you cannot resolve installation-problems, write an email with the attached installcourse.log
file to the dumux mailing list (dumux@listserv.uni-stuttgart.de).
When was this course last updated?
Last updated for: DuMux course 2024.
Funding acknowledgement
The 2024 update of the dumux-course was financially supported by the German Research Foundation (DFG) within the Collaborative Research Center on Interface-Driven Multi-Field Processes in Porous Media (SFB 1313, Project No. 327154368). T. Koch acknowledges funding by the European Union's Horizon 2020 research and innovation programme under the Marie Skłodowska-Curie grant agreement No 801133. D. Gläser thanks the Federal Government and the Heads of Government of the Länder, as well as the Joint Science Conference (GWK), for their funding and support within the framework of the NFDI4Ing consortium; funded by the German Research Foundation (DFG), Project No. 442146713.