Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Register
  • Sign in
  • dumux-course dumux-course
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 6
    • Issues 6
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 1
    • Merge requests 1
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Container Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • dumux-repositoriesdumux-repositories
  • dumux-coursedumux-course
  • Issues
  • #30
Closed
Open
Issue created Jan 17, 2022 by Axel Schumacher@schumaaxContributor

Improve documentation of basic course scenario

Problem: The dumux course has to be set up in a specific way to work as expected. Well documentation will help beginners.

During my work on doing the dumux course (basics exercise), I found that the documentation for beginners could be improved.
This Issue is to discuss this and avoid spam in the mailing list for everyone who is not involved. Thanks @timok for your response 👍.

Problem and solution description

My intuition was that it would be possible to

  • clone the dumux course repository into the existing dumux installation and then
  • build the project files in the moment when they are needed.

This may be possible, but leads to confusion because the steps in this case are different from those in the Tutorial description.

My solution that works was to

  • copy the installexternal.py-file from myInstallationFolder/dumux/dumux/bin to myInstallationFolder/dumux,
  • change to the new directory of this file (cd myInstallationFolder).
  • run python3 installexternal.py course to add the dumux-course to the existing DuMuX-installation and follow the steps mentioned while the installation is running.

After the installation is complete I could remove the installexternal.py file from this directory to clean up.

The way @timok proposes is as follows:

  • clone the dumux course repository into the existing dumux installation,
  • configure using CMake or dunecontrol and
  • build the Dune modules and Dumux libraries you want to use.

Did I got that correct?

How to improve this

In order to improve the documentation, I see two possibilities:

  1. Extend the Preparing the exercise section in the basics exercise with my solution or the one proposed by @timok or to
  2. Give more details on how to get the course on the getting started guide on the homepage.

I'd like to implement this, please let me know which way the community prefers. I think both solutions are possible without duplicate resources, which avoids maintenance effort.

Assignee
Assign to
Time tracking