Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ompp build docs #1926

Merged
merged 3 commits into from
Dec 19, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/en/8-MicroSim/Additions
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
## Adding a New Model

**Note**: use a notebook with at least 4Gb of memory for this full guide.

First clone the model's repository or download and extract the archived model on your AAW notebook. In our example, we clone oncosim from gitlab:

![Oncosim dir is now available](image.png)

### Compiling the model

In this case, we are compiling for mpi, so we retrieved the appropriate OMPP release from the [openmpp releases page](https://github.com/openmpp/main/releases). Make sure to use the archived releases provided by openM and not auto-generated by Github.

We can follow the readme of the model. In this case, we set our `OM_ROOT` environment variable to the same directory as our OMPP release using `export OM_ROOT=~/buckets/aaw-unclassified/microsim/openmpp_ubuntu_mpi_20231115`.

We can now compile. We make sure that we're in the oncosim directory then run `make OM_MSG_USE=MPI RELEASE=1 all publish`.

Once compilation is complete, our compiled model files appear under `<path-to-oncosim>/ompp-linux/bin/`. Using the terminal, `cp` the files in the `bin` directory to `~/buckets/aaw-unclassified/microsim/models/bin`.

![oncosim model files under bin](image-2.png)

Using the terminal, `cp -r ` the entire model directory to `~/buckets/aaw-unclassified/microsim/models`

![oncosim under microsim](image-1.png)

Once complete, run `restart-oms.sh` in the terminal. This will restart the OpenM web service and allow it to pick up the new model.

![model in UI](image-3.png)
Binary file added docs/en/8-MicroSim/image-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en/8-MicroSim/image-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en/8-MicroSim/image-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en/8-MicroSim/image.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions mkdocs-en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -113,4 +113,5 @@ nav:
- Integrate with External PaaS: 7-MLOps/PaaS-Integration.md
- MicroSim:
- Getting Started: 8-MicroSim/GettingStarted.md
- Adding new models: 8-MicroSim/Additions.md
- Help/Contact: Help.md
Loading