Open Malaria

This git-repository contains source-code for Open Malaria, a simulator program for studying malaria epidemiology and the impacts of interventions against malaria.

---

For further documentation, take a look at our wiki.

Also find our code on zenodo, with DOI-references:

Schema documentation for the XML input files can be found on the wiki or in the schema folder (both past releases and development version).

You can download the latest build here: releases

Status of master builds:

Status of develop builds:

Code Coverage:

License: GPL v2 (see COPYING).

Version

The schema version is specified in the following places (all need to be updated when releasing a new version):

• DocumentLoader.h
• schema/scenario.xsd, demography.xsd, etc. (all XSD files without a version number)
• schema/CMakeLists.txt (namespace-map)
• copy build/schema/scenario_current.xsd to schema/scenario_XX.xsd
• test/*.xml — update http://openmalaria.org/schema/scenario_XX and (optionally) schemaVersion="XX"
• version.txt — needed for build service

In theory the "schema namespace version" doesn't need to match the "OpenMalaria" version and we could update the latter without requiring changes to XML files, however currently we keep both synchronised (in some ways this is simpler).

Installation instructions:

See INSTALLATION.

Build instructions:

mkdir build && cd build
ccmake ..
Press 'c', look over options, press 'c' again and 'g'
make -j4
ctest -j4

For testing and development, ideally use debug builds (which enable some asserts to do with simulation time usage).

Code subdirectories:

- dir -	- description -
contrib	Third-party libraries, distributed under the same repo for convenience.
model	Source code for the malaria model.
test	High-level testing: test scenarios with expected outputs. Also run-time files: densities.csv, scenario_?.xsd, Nv0scenario*.txt.
unittest	Low-level testing: unittests for the model using cxxunit.
util	Extra scripts associated with OpenMalaria.
schema	scenario schema files (see schema/policy.txt for details)
schema/scenario.xsd	The latest (partial) schema file.
schema/entomology.xsd, schema/demography.xsd, etc	components of the latest schema, included from scenario.xsd.
schema/scenario_*.xsd	Copies of released schema versions, with all components inlined in the same file.

This git repository is currently maintained by members of the Dynamical Modelling Group of the Swiss Tropical and Public Health institute and other collaborators.