MultiMalModPy: A Python Framework for Multi-Model Malaria Simulation

Documentation and User Guide

About MultiMalModPy

A new HPC-oriented framework in Python and R that enables users to interact with EMOD, malariasimulation, and OpenMalaria. This framework is designed for modelers already familiar with one of these models, as well as for those who wish to learn more about all three models in a unified and accessible approach.

MultiMalModPy takes user input to generate malaria simulations and produces daily, monthly, and yearly outcome measures. It is designed to allow running either one or all three of the models to enable model characterization and comparison.

About this Guide

This documentation is designed to support both new and experienced users of MultiMalModPy, providing structured guidance while supplementing—rather than replacing—the original documentation for each model.

Scope of This Documentation
1. Comparative Model Information – High-level descriptions of each model, including links to their original source documentation for further reference.
2. User Guidance – Detailed instructions, best practices, and resources tailored to facilitate both introductory learning and advanced usage of MultiMalModPy.

📝 NOTE: This guide is intended as a supplementary resource and does not substitute the official documentation of the three models.

Content Overview

MALARIA MODELS
     Overview and comparison of the different malaria models supported by MultiMalModPy.

USER GUIDE
     Step-by-step instructions for installing, configuring, and running MultiMalModPy, including parameter customization and platform-specific execution.

SIMULATION GUIDE
     Information and documentation on the parameters available to define simulations using MultiMalModPy.

DEVELOPER GUIDE
     Documentation for contributors, covering intervention development, model versioning, containerization, and maintenance.

API
     Reference for framework-specific classes, functions, and scripts used within MultiMalModPy.

ABOUT
     Background on the MultiMalModPy framework, including contributors, references, and contact information.

Release and download

Initial release expected in Q3 2025.