Skip to content

Conversation

@PavelBal
Copy link
Member

No description provided.

@PavelBal PavelBal requested a review from Copilot August 27, 2025 18:16

To create your first MoBi® project, simply follow the steps described in the sections below.

## Start the Program‌
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to describe how to start an application..

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR reworks the first-steps documentation for MoBi® to reflect significant changes in the application's interface and functionality. The documentation is updated to reflect a new modular approach and interface changes.

  • Updates interface terminology from "Building Block Explorer" to "Modules Explorer" and related UI changes
  • Replaces detailed step-by-step model creation tutorial with focus on importing PK-Sim® models and module-based workflow
  • Streamlines content by removing extensive manual model building instructions in favor of referencing other documentation sections

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.


In the following we describe some details of the different subviews.

The **Modeling & Simulation ribbon bar** is separated into the **History** group, **Create Building Blocks** group, the **Simulation** group, options for specific **Workflows** and the **Project** functionality that helps to manage and display the units of parameters. **Views** contains the selection of the basic windows in MoBi®, the building block explorer window, the simulation explorer, and the history manager window.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was outdated, and I don't see a point of updating it.


The first step to start working with MoBi® is to create a new project. To do this, click on the **New Project** command in the File menu. You can either work with amount or concentration based reaction networks which needs to be specified when creating a new project. Empty building blocks are automatically created shortly after in the **Building Block Explorer**: Molecules, Reactions, Spatial Structures, Passive Transports, Observers, and Events. Some of these building blocks need to be filled with data, which is successively done in the next sections.

## Enter Molecules‌
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This whole example would not work because the description of creating the spatial structures is missing! I have extracted this example into a separate file here #277

It could be finalized and offered later. As I said, right now it is useless.

Congratulations, you have done your first simulation using MoBi®!
{% endhint %}

## Running a PK-Sim® Simulation‌
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Importing of a PK-Sim simulation is described above.

7. In the Data Browser section of the chart editor, select the proper organ and compartment as in your PK-Sim® project, for example Peripheral Venous Blood, and then Plasma. Check the box ![Image](../assets/icons/Checked.png) in the column "Used". A PK curve should appear; if all went right, the results displayed in MoBi® should be the same as displayed with your original PK-Sim® simulation.
6. Click the orange arrow <img src="../assets/icons/Run.svg" data-size="line"> ribbon button to run the simulation, or alternatively press the **F5** key.

## Exit MoBi®‌
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lol

@PavelBal PavelBal requested a review from Yuri05 August 27, 2025 18:21
@Yuri05
Copy link
Member

Yuri05 commented Aug 28, 2025

The program overview image has to be updated as well.

@PavelBal
Copy link
Member Author

Yes, I have created issues for screenshot updates:

#253
#248
#254

I don't have time for it right now, we should find someone else to do it.

@PavelBal PavelBal merged commit b9d2efa into v12 Aug 28, 2025
0 of 3 checks passed
@PavelBal PavelBal deleted the part-4-first-steps branch August 28, 2025 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants