Skip to content
Snippets Groups Projects
Select Git revision
  • feature/test_periodic_subgrid
  • feature/hybrid-pq1-new-problem
  • feature/hybrid-pq1
  • feature/cvfe-localvariables
  • feature/cvfe-localdofs
  • fix/test-reduce-timestep-variation
  • feature/periodicity-subgrid
  • releases/3.10 protected
  • master default protected
  • fix/compositional-dispersion-use-moles
  • cleanup/py-compatibility-code
  • doc/newton-documentation
  • releases/3.9 protected
  • fix/1pni-velocityx-zero-threshold
  • doc/update-changelog
  • feature/gridformat-reader
  • fix/intersections-3d3d
  • feature/constant-extrusion
  • fix/checkpoints_failed_for_small_epsilon
  • feature/air-henry-implementation
  • 3.9.0
  • 3.9.0-rc1
  • 3.8.0
  • 3.8.0-rc1
  • 3.7.0
  • 3.7.0-rc1
  • 3.6.0
  • 3.6.0-rc1
  • 3.5.0
  • 3.5.0-rc1
  • 3.4.0
  • 3.4.0-rc1
  • 3.3.0
  • 3.3.0-rc1
  • 3.2.0
  • 3.2.0-rc2
  • 3.2.0-rc1
  • 3.1.0
  • 3.1.0-rc1
  • 3.0.0
40 results
Compare
Name Last commit Last update
.gitlab
bin
cmake/modules
doc
dumux
examples
patches
python
test
.gitignore
.mailmap
CHANGELOG.md
CMakeLists.txt
CONTRIBUTING.md
COPYING
LICENSE.md
README.md
cmake.opts
config.h.cmake
docker.opts
dumux.pc.in
dune.module
pyproject.toml
setup.py
README.md
dumux logo

What is DuMux?

DuMux is a simulation toolbox mainly aimed at flow and transport processes in porous media. DuMux is based on the DUNE framework and aims to provide a multitude of numerical models as well as flexible discretization methods for complex non-linear phenomena, such as CO2 sequestration, soil remediation, drug delivery in cancer therapy and more. Have a look at our publications (see below: How to cite) for a more detailed description of the goals and motivations behind DuMux.

Installation

Have a look at the installation guide or use the DuMux handbook, Chapter 2.

Documentation

The following resources are useful to get started with DuMux:

Some helpful code snippets are available in the Wiki.

License

DuMux is licensed under the terms and conditions of the GNU General Public License (GPL) version 3 or - at your option - any later version. The GPL can be read online or in the LICENSE.md file provided in the topmost directory of the DuMux source code tree.

Please note that DuMux' license, unlike DUNE's, does not feature a template exception to the GNU General Public License. This means that you must publish any source code which uses any of the DuMux header files if you want to redistribute your program to third parties. If this is unacceptable to you, please contact us for a commercial license.

See the file LICENSE.md for full copying permissions.

How to cite

DuMux is research software and developed at research institutions. If you are using DuMux in scientific publications and in the academic context, please cite (at least one) of our publications:

  • [Koch, T., Gläser, D., Weishaupt, K., Ackermann, S., Beck, M., Becker, B., Burbulla, S., Class, H., Coltman, E., Emmert, S., Fetzer, T., Grüninger, C., Heck, K., Hommel, J., Kurz, T., Lipp, M., Mohammadi, F., Scherrer, S., Schneider, M., Seitz, G., Stadler, L., Utz, M., Weinhardt, F. & Flemisch, B. (2020). DuMux 3 – an open-source simulator for solving flow and transport problems in porous media with a focus on model coupling. Computers & Mathematics with Applications, https://doi.org/10.1016/j.camwa.2020.02.012][7]

  • [Flemisch, B., Darcis, M., Erbertseder, K., Faigle, B., Lauser, A., Mosthaf, K., Müthing, S., Nuske, P., Tatomir, A., Wolff, M., & Helmig, R. (2011). DuMux: DUNE for multi-{phase,component,scale,physics,…} flow and transport in porous media. Advances in Water Resources, 34(9), 1102–1112. https://doi.org/10.1016/j.advwatres.2011.03.007][2]

You can also cite specific releases published on Zenodo: zenodo badge

Automated Testing

  • DuMux 3.3 / Dune 2.7: buildbot badge
  • DuMux master / Dune 2.7: buildbot badge
  • DuMux master / Dune master: buildbot badge

DuMux features many tests (some unit tests and test problems) that can be run manually. We have experimental support for automated testing with buildbot. Click here (buildbot) to see the latest builds (clicking on a build number will show a detailed overview of the build).

coverage report

A weekly coverage report of the test suite is created by gcovr/gcov. The report currently doesn't include non-instantiated code, so the real coverage is likely lower. However, only a few lines of code are never instatiated in the comprehensive test suite.

Contributing

Contributions are highly welcome. Please ask questions over the mailing list. Please review the contribution guidelines before opening issues and merge requests. For bug reports contact us over the mailing list, or file an issue. For bug fixes, feature implementations open a merge request or send us formatted patches.

Backwards Compatibility

For a detailed description of the backwards compatibility policy, please see contribution guidelines.

DuMux releases are split into major(e.g. 2.0, 3.0) and minor (e.g. 3.1, 3.2, 3.3) releases. Major releases are not required to maintain backwards compatibility (see below), but would provide a detailed guide on how to update dependent modules. For each minor release, maintaining backwards compatibility is strongly encouraged and recommended.

Despite the goal of maintaining backwards compatibility across minor releases, for more complicated changes, this is decided upon on a case to case basis, due to limited developer resources. In the case that implementing full backwards compatibility for an update is not feasible, or would require unreasonable resources, the degree of backwards compatibility be decided by a vote in one of the monthly core developer meetings.

Major version update, 2.12 to 3.0

With the version update to version 3, many features have been added and a lot has been improved in DuMux. See the changelog for a list of changes. If you decide to update from version 2.12, please have a look at our small guide on how to update an application to the new version.