MetaWards
Please take a look at the features to see what MetaWards can do. Follow the quick start guide to see how to quickly get up and running using MetaWards to model your own custom disease or metapopulation model.
Citation
Please cite use of this software following the instructions in the “Cite this repository” link in the GitHub repository, and also please cite our [Journal of Open Source Software paper](https://doi.org/10.21105/joss.03914).
Scientific Background
MetaWards implements a stochastic metapopulation model of disease transmission. It can scale from modelling local transmission up to full national- or international-scale metapopulation models.
This is a Python port of the MetaWards package originally written by Leon Danon. This port has been performed with Leon’s support by the Bristol Research Software Engineering Group.
It is was originally developed to support modelling of disease transmission in Great Britain. The complete model description and the original C code are described here;
“The role of routine versus random movements on the spread of disease in Great Britain”, Leon Danon, Thomas House, Matt J. Keeling, Epidemics, December 2009, 1 (4), 250-258; DOI: 10.1016/j.epidem.2009.11.002
“Individual identity and movement networks for disease metapopulations”, Matt J. Keeling, Leon Danon, Matthew C. Vernon, Thomas A. House Proceedings of the National Academy of Sciences, May 2010, 107 (19) 8866-8870; DOI: 10.1073/pnas.1000416107
In this model, the population is divided into electoral wards. Disease transmission between wards occurs via the daily movement of individuals. For each ward, individuals contribute to the force of infection (FOI) in their home ward during the night, and their work ward during the day.
This model was recently adapted to model CoVID-19 transmission in England and Wales, with result of the original C code published here;
“A spatial model of CoVID-19 transmission in England and Wales: early spread and peak timing”, Leon Danon, Ellen Brooks-Pollock, Mick Bailey, Matt J Keeling, Philosophical Transactions of the Royal Society B, 376(1829); DOI: 10.1098/rstb.2020.0272
This Python code is a port which can identically reproduce the outputs from the original C code as used in that work. This Python code has been optimised and parallelised, with additional testing added to ensure that development and scale-up of MetaWards has been robustly and efficiently conducted.
Features
Installation
Model Data
Quick Start Guide
Tutorial
- Tutorial
- Part 1 - Modelling outbreaks
- Part 2 - Refining the model
- Part 3 - Customising the outbreak
- Part 4 - Customising the output
- Part 5 - Modelling multiple demographics
- Part 6 - Moving between demographics
- Part 7 - Different pathways for different demographics
- Part 8 - Creating your own models / networks
- Part 9 - Advanced Moves and Scenarios
Files
Usage
Getting help
Contributing
Documentation
Changelog
- Changelog
- 1.6.2 - March 18th 2022
- 1.6.1 - October 11th 2021
- 1.6.0 - May 25th 2021
- 1.5.1 - February 26th 2021
- 1.5.0 - February 9th 2021
- 1.4.1 - November 18th 2020
- 1.4.0 - August 14th 2020
- 1.3.0 - July 22nd 2020
- 1.2.0 - June 26th 2020
- 1.1.0 - June 11th 2020
- 1.0.0 - May 23rd 2020
- 0.12.0 - May 18th 2020
- 0.11.2 - May 11th 2020
- 0.11.1 - May 10th 2020
- 0.11.0 - May 10th 2020
- 0.10.0 - April 27th 2020
- 0.9.0 - April 24th 2020
- 0.8.5 - April 22nd 2020
- 0.8.3 - April 21st 2020
- 0.8.0 - April 21st 2020
- 0.7.1 - April 17th 2020
- 0.7.0 - April 17th 2020
- 0.6.0 - April 9th 2020
- 0.5.0 - April 8th 2020
- 0.4.0 - April 7th 2020
- 0.3.1 - April 5th 2020
- 0.3.0 - April 5th 2020
- 0.2.0 - March 31st 2020
- 0.1.0 - March 29th 2020
- Start of the Python port - March 25th 2020