# Projects

The organization of simulations is supported by PK-Sim® with a building block concept. Each project contains a **Building Blocks** panel that comprises one or several building blocks for individuals, populations, compounds, formulations, protocols, events and observed data. Simulations that are created with the building blocks and comparisons of simulations are organized in a separate panel. The user can create subfolders for organization of observed data, simulations and comparison.

{% hint style="info" %}
Only one project can be opened at a time in one PK-Sim® instance. If you wish to work on more than one project in parallel you may start separate instances of PK-Sim® for each individual project. If the identical project is already being accessed by yourself or by another user, PK-Sim® will warn you and open the project as read-only. You will still be able to use the project but won't be able to save your changes.
{% endhint %}

The following table gives an overview on how to manage projects using the **File** tab:

| Function, Icon                                                                                             | Shortcut | Description                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Create a new project<br><img src="/files/lqVLRKnnEqxwbQjb3aW1" alt="" data-size="line"></p>             | Ctrl+N   | A new project is generated. The current project is closed. If you have not saved the current project yet, you will be asked if you want to do so. If you answer Yes, all data belonging to the current project are saved using the current file-name. If the project/file name is undefined, a dialog window will open for you to specify the project name. |
| <p>Open an existing project<br><img src="/files/tzyAFB0nm9JXunhMQiib" alt="" data-size="line"></p>         | Ctrl+O   | <p>Select the \*.pksim5 file you want to open.<br>• Only one project can be opened at a time. If a project is already open, you are asked if the currently open project should be saved before closing.<br>• If you wish to work on more than one project in parallel, you may start separate instances of PK-Sim® for each individual project.</p>         |
| <p>Close the project<br><img src="/files/0u5C0wKbycJ4fMWQUIvw" alt="" data-size="line"></p>                |          | The project is closed. If you have not yet saved the current project, you are asked if you want to do so. If you answer Yes, all data belonging to the project are saved using the current file-name. If the project/ file name is undefined, a will open for you to specify the project name. A new project can then be created, subsequently.             |
| <p>Save the project<br><img src="/files/Ofc433c2liEKNbgeQhtq" alt="" data-size="line"></p>                 | Ctrl+S   | You can save your project by either selecting Save or Save as.                                                                                                                                                                                                                                                                                              |
| <p>Show or edit project description<br><img src="/files/AkcvY1w1L5ACjC4OceXP" alt="" data-size="line"></p> | Ctrl+D   | You can enter, show or change a description for the project.                                                                                                                                                                                                                                                                                                |
| <p>Export project to snapshot<br><img src="/files/g3pKmGHtJ24A1Rx7zldf" alt="" data-size="line"></p>       |          | <p>Export current project to snapshot.<br>S. <a href="/pages/-LNl8PUzJ6zR2WJPrmXt#exporting-project-to-snapshot--loading-project-from-snapshot">Exporting Project to Snapshot / Loading Project from Snapshot</a> for details.</p>                                                                                                                          |
| <p>Load project from snapshot<br><img src="/files/32lTTLqTLRxeNclT0DE0" alt="" data-size="line"></p>       |          | <p>Create a new project from snapshot.<br>S. <a href="/pages/-LNl8PUzJ6zR2WJPrmXt#exporting-project-to-snapshot--loading-project-from-snapshot">Exporting Project to Snapshot / Loading Project from Snapshot</a> for details.</p>                                                                                                                          |
| <p>Select Journal<br><img src="/files/xmG60tntwygzCtr5GCFk" alt="" data-size="line"></p>                   |          | <p>Assign a working journal to the current project.<br>S. <a href="/pages/-LNl8PVLSLYycEK0CNbA">Shared Tools - Working Journal</a> for details.</p>                                                                                                                                                                                                         |
| <p>About this application<br><img src="/files/mpC5FkL3O6rfTmjW8mJl" alt="" data-size="line"></p>           |          | An overview of the PK-Sim® version information is given.                                                                                                                                                                                                                                                                                                    |
| <p>Exit the application<br><img src="/files/QyJey3kDiPYqIFTIwsUZ" alt="" data-size="line"></p>             | Alt+F4   | PK-Sim® is closed. If you have not yet saved the current project, you are asked if you want to do so. If you answer Yes, all data belonging to the project are saved using the current file-name. If the project name is undefined, a dialog window will open for you to specify the project name.                                                          |

The visualization of a project is organized in different panels. Each panel can be hidden or be made visible by clicking on the respective icon in the **Views** Tab. The panels have the following meaning:

| Panel, Icon                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Building Blocks<br><img src="/files/sA2AWLhBuKyIVVOFyVIg" alt="" data-size="line"></p>         | <p>Within this panel the building blocks <strong>Expression Profiles</strong>, <strong>Individuals</strong>, <strong>Populations</strong>, <strong>Compounds</strong>, <strong>Formulations</strong>, <strong>Administration Protocols</strong>, <strong>Events</strong>, <strong>Observers</strong>, and <strong>Observed Data</strong> are organized and can be accessed. Detailed information for each building block can be found in:<br>● <a href="/pages/RKr2PZBs7l9yPBvqBhcn">PK-Sim® - Expression Profiles</a><br>● <a href="/pages/-LNl8PUma5oCfRE0IKRk">PK-Sim® - Creating Individuals</a><br>● <a href="/pages/-LNl8PUnqF-Hzqw85Dy1">PK-Sim® - Creating Populations</a><br>● <a href="/pages/-LNl8PUq1DmKyqVnfusA">PK-Sim®- Compounds: Definition and Work Flows</a><br>● <a href="/pages/-LNl8PUw6z-gXuG3hhVY">PK-Sim® - Formulations</a><br>● <a href="/pages/-LNl8PUsYcipT5YEKBAx">PK-Sim® - Administration Protocols</a><br>● <a href="/pages/-LNl8PUtcKAAfkgn7BlG">PK-Sim® - Events</a><br>● <a href="/pages/-LNl8PVIPtIEsGJAGYYt">Shared Tools - Import and Edit of Observed Data</a>.</p> |
| <p>Simulations<br><img src="/files/brwfxu2dum15yFe7cQOo" alt="" data-size="line"></p>             | <p>In this panel all simulations of a project are managed. A detailed description on how simulations are set up and managed can be found in <a href="/pages/-LNl8PUx7qgfoHXq0YAG">PK-Sim® - Simulations</a>.<br>Besides simulations, this panel contains the following objects:<br>● Simulation comparisons (s. <a href="/pages/-LNl8PUx7qgfoHXq0YAG#comparison-chart-for-individual-or-population-simulations-in-one-plot">PK-Sim® - Simulations: Comparison charts</a> for details)<br>● Parameter Identifications (s. <a href="/pages/-LNl8PVGr42S6a6nWE8r">Shared Tools - Parameter Identification</a> for details)<br>● Sensitivity Analyses (s. <a href="/pages/-LNl8PVH8-6O_29RMFYr">Shared Tools - Sensitivity Analysis</a> for details)<br></p>                                                                                                                                                                                                                                                                                                                                                    |
| <p>History Manager<br><img src="/files/B7qkA1zxzBOrwKHAEwBK" alt="" data-size="line"></p>         | Every user action performed within a given project work is documented within this panel. Features of the History Manager are described in [Shared Tools - History manager and history reporting](/shared-tools-and-example-workflows/history-manager-history-reporting.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p>Comparison<br><img src="/files/NXdPeUAA7WdDAUExb5q9" alt="" data-size="line"></p>              | <p>Shows comparison results of 2 building blocks or 2 simulations.<br>S. <a href="/pages/-LNl8PVFllp88sUfl47y">Shared Tools - Comparison of Building Blocks</a> for details.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p>Working Journal<br><img src="/files/vnEBrdxdw87fzYaueQJx" alt="" data-size="line"></p>         | <p>Shows the working journal of the current project.<br>S. <a href="/pages/-LNl8PVLSLYycEK0CNbA">Shared Tools - Working Journal</a> for details.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p>Working Journal Diagram<br><img src="/files/6UYJOi7rlKDumSZwPXxA" alt="" data-size="line"></p> | <p>Shows the working journal of the current project.<br>S. <a href="/pages/-LNl8PVLSLYycEK0CNbA#the-journal-diagram">Shared Tools - Working Journal</a> for details.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.open-systems-pharmacology.org/working-with-pk-sim/pk-sim-documentation/pk-sim-projects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
