Skip to content

GitLab

The TS-GitLab will have to shut down towards the end of the year — please think about migrating your projects to GitLab.com or GitHub.
(This is still a very early message, meant to keep you informed. There will be more urgent ones in the future.)

Closed
Created by Lukas Riedel@lriedelOwner0 of 1 task completed0/1 task

Document model solver loop and time step adaptation schemes in user manual

The following discussion from !181 (merged) should be addressed:

  • @sospinar started a discussion: (+1 comment)

    We should probably document the time step scheme algorithm(s) in the user manual.

    How about using a uml diagram?

    This would be a sketch of a possible diagram. @lriedel Do you know how to add a box on the way back of the while loop?

Description

We need to document the (slightly different) solver routines of the Richards and transport models in the user manual. @sospinar suggested using a UML diagram with the PlantUML extension of Sphinx.

Proposal

  • Add sphinxcontrib-plantuml to the requirements.txt of the user docs.

  • Add 'sphinxcontrib.plantuml' to the Sphinx extensions in the conf.py.

  • Document the time step schemes:

    • Richards model: Explain allowed Newton iterations and relation to time step.
    • Transport model: Explain solution check first implemented in !181 (merged).

    Finalize proposal for loop visualization here

How to test the implementation?

Nothing to test.

Related issues

Edited by Lukas Riedel
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information