MoBi Documentation on Equations

[maalbrec89]

Hello everyone,

I did not found the documentation section for equations last time. Later I found it here: MoBi Documentation/Model Building and Model Components/Working with Formulas where I haven't expected it.

The section "Model Building and Model Components" became so large recently that I suggest splitting it up and providing a whole section on Formulas/Equations.

[msevestre]

Great idea

Hint hint: The documentation is open source https://docs.open-systems-pharmacology.org/how-to-contribute

[maalbrec89]

I like it and would use this contributing option.

However, I think it is a bigger structural change, which includes the introduction of new pages. I feel a bit uncomfortable doing it and would suggest that someone does it who has more experience with Gitbook.

[StephanSchaller]

@maalbrec89 , maybe you can propose what document structure (pages & subsections you would propose. If agreed, @msevestre could set them up and then you can add the content?

[maalbrec89]

I looked again. I would basically completely dissolve the chapter "Model Building and Model Components" because it is too generic and thus not easy for people who search sth. Then I would just lift the sections within this document one level up almost as they are:

• MoBi Projects
• Parameters, Formulas, and Tags
• Spatial Structures
• Molecules (maybe combined with reactions ---> "Molecules and Reactions")
• Reactions (maybe combined with molecules ---> "Molecules and Reactions")
• Transport Processes
• Observers ( maybe combined with Events and Applications ---> "Application, Events, and Observers")
• Events and Applications ( maybe combined with Observers ---> "Application, Events, and Observers")

Then one might combine four remaining sections to the section "Start Values for molecules and Parameters"

• Molecule Start Values
• Parameter Start Values
• Import Molecule and Parameter Start Values from Excel‌
• Editing of Molecule and Parameters

or shift the remaining sections

• Molecule Start Values --> shift to section Molecules
• Parameter Start Values --->shift to section "Parameters, Formulas, and Tags"
• Import Molecule and Parameter Start Values from Excel‌ --> distributing
• Editing of Molecule and Parameters ---> distributing

Similar thoughts (maybe too fast) to Setting up a Simulation One might uplift the following sections and call them "Numerics":

• Output Intervals
• ODE Solver Properties

I guess it is just because the OSPS has been advanced so much lately that one might rework or outbalance the documentation structure.