Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
D
dorie
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 31
    • Issues 31
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 9
    • Merge Requests 9
  • Operations
    • Operations
    • Incidents
    • Environments
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
  • dorie
  • dorie
  • Issues
  • #174

Closed
Open
Opened Jan 09, 2020 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 Jan 09, 2020 by Lukas Riedel
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information
Assignee
Assign to
v2.0 Release
Milestone
v2.0 Release
Assign milestone
Time tracking
None
Due date
None
Reference: dorie/dorie#174