Welcome to EMOD malaria modeling¶
The Institute for Disease Modeling (IDM) develops disease modeling software that is thoroughly tested and shared with the research community to advance the understanding of disease dynamics. This software helps determine the combination of health policies and intervention strategies that can lead to disease eradication. If you encounter any issues while using the software, please contact support@idmod.org.
Epidemiological MODeling software (EMOD), is an agent-based model (ABM) that simulates the simultaneous interactions of agents in an effort to recreate complex phenomena. Each agent (such as a human or vector) can be assigned a variety of “properties” (for example, age, gender, etc.), and their behavior and interactions with one another are determined by using decision rules. These models have strong predictive power and are able to leverage spatial and temporal dynamics.
EMOD is also stochastic, meaning that there is randomness built into the model. Infection and recovery processes are represented as probabilistic Bernoulli random draws. In other words, when a susceptible person comes into contact with a pathogen, they are not guaranteed to become infected. Instead, you can imagine flipping a coin that has a λ chance of coming up tails S(t) times, and for every person who gets a “head” you say they are infected. This randomness better approximates what happens in reality. It also means that you must run many simulations to determine the probability of particular outcomes.
Documentation structure¶
Using the model contains information that will help you get started with EMOD, including installation instructions, a basic overview of the software, and some example simulations you can run on your computer.
Understanding the model contains more detailed information about the disease biology, workings of the EMOD model, complete parameter reference, and a glossary.
Advancing the model contains information for researchers and developers who want to modify the EMOD source code to add more functionality to the model.
The EMOD documentation is broken up into disease-specific sets that provide guidance for researchers modeling particular diseases. The documentation contains only the parameters, output reports, and other components of the model that are available to use with this disease model.
For example, this documentation set includes general installation and usage instructions that are common in all simulation types in addition to content specific to modeling malaria and other vector-borne diseases.
- What’s new
- EMOD installation
- Overview of EMOD software
- Input files
- Running a simulation
- Output files
- Inset chart output report
- Binned output report
- Demographic summary output report
- Node demographics report (ReportNodeDemographics.csv)
- Event counter report (ReportEventCounter.json)
- Health events and interventions report
- Human migration tracking report (ReportHumanMigrationTracking.csv)
- Property output report
- Spatial output report
- Custom reporters
- Error and logging files
- Vector species output report (VectorSpeciesReport.json)
- Vector habitat report (VectorHabitatReport.json)
- Vector life cycle stats report (ReportVectorStats.csv)
- Vector genetics report (ReportVectorGenetics.csv)
- Population-level malaria summary report (MalariaSummaryReport.json)
- Vector statistics report (ReportVectorStats.csv)
- Malaria vector statistics report (ReportVectorStatsMalaria.csv)
- Detailed malaria survey report (MalariaSurveyJSONAnalyzer.json)
- Malaria immunity report (MalariaImmunityReport.json)
- Malaria patient data report (MalariaPatientReport.json)
- Malaria inset chart report (ReportMalariaFiltered.json)
- Malaria transmission report (MalariaTransmissionReport.json)
- Malaria node demographics report (ReportNodeDemographicsMalaria.csv)
- Malaria spatial output report (SpatialReportMalariaFiltered.json)
- Tutorials and simulation examples
- Troubleshooting EMOD simulations
- Model overview
- Malaria disease overview
- EMOD parameter reference
- Demographics parameters
- Configuration parameters
- Drugs and treatments
- Enable or disable features
- General disease
- Geography and environment
- Immunity
- Incubation
- Infectivity and transmission
- Input files
- Larval habitat
- Migration
- Mortality and survival
- Output settings
- Parasite dynamics
- Population dynamics
- Sampling
- Scalars and multipliers
- Simulation setup
- Symptoms and diagnosis
- Vector control
- Vector life cycle
- Campaign parameters
- Generate a list of all available parameters (a schema)
- Frequently asked questions
- Glossary
- EMOD source code installation
- EMOD architecture
- Debugging and testing