Installation¶

View image file

View image file

View image file

1️⃣ Install Docker Desktop¶

Download and install from 🔗 Docker Desktop.
Ensure the Docker daemon is running:

docker info

If it’s not running, open Docker Desktop (especially on Windows).

2️⃣ Pull the Docker Image¶

Pull the container image from Docker Hub:

docker pull mrm9534/mmmpy_local:rocky8

🔗 View image on Docker Hub

3️⃣ Verify the Image¶

Confirm the image exists locally:

docker images

Look for mrm9534/mmmpy_local with the tag rocky8.

4️⃣ Run the Docker Container¶

Start the container in interactive mode:

docker run -it --name mmmpy_container mrm9534/mmmpy_local:rocky8 /bin/bash

To resume an existing container instead of creating a new one:

docker ps -a # List all containers docker start -ai mmmpy_container

You should see a terminal like:

[root@74350592befb /]#

🛑 To exit the container, type:

exit

5️⃣ Activate the Python Virtual Environment¶

Check for available environments:

ls /opt/envs/

You’ll likely see mmmpy_container or mmmpy_local.

Activate the correct one:

source /opt/envs/mmmpy_container/bin/activate

Your prompt should look like:

(mmmpy_container) [root@74350592befb envs]#

Verify the Python setup:

python --version pip list

Run a Test Simulation (from Host System)¶

If you’re inside the container, exit first.

Then run from your host terminal:

docker run -it -v <USERPATH>:/mnt/c/projects \ mrm9534/mmmpy_local:rocky8 \ /bin/bash -c "source /opt/envs/mmmpy_container/bin/activate && cd /mnt/c/projects/MultiMalModPy && python launch_sim.py --models malariasimulation OpenMalaria --test"

🔁 Replace <USERPATH> (e.g., C:\Users\YourName\Documents) with the full path to your MultiMalModPy folder.

📘 More details: Example Run – Docker Container

If your test run using EMOD fails, it may be due to missing dependencies or version conflicts. Below are common issues and how to resolve them:

Missing python package or version conflict

ERROR: Could not find a version that satisfies the requirement click==7.1.2 ERROR: No matching distribution found for click==7.1.2

Solution: Manually install the required version: pip install click==7.1.2

If the installation of idmtools with SLURM support fails, you might see an error like this:

Solution: Retry the installation using:

pip install idmtools[slurm] --index-url=https://packages.idmod.org/api/pypi/pypi-production/simple

Dependency Version Conflict

ERROR: pip’s dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. emodpy 1.22.1 requires click~=7.1, but you have click 8.1.8 which is incompatible. - Run required package installation i.e.

    pip install click==8.1.7

If a dependency conflict remains, let us know and try again to verify installation.

EMOD ValueError (Likely Due to Wrong emodpy-malaria Version)

• EMOD ValueError: If it seems that EMOD is running, but you get a ValueError, this indicates that a wrong version of ’ emodpy-malaria’ has been installed. Please let us know and we will update the online documentation.
  An example is shown in the screenshot below: