Build Status PyPi version PyPi project Number of downloads GitHub commit activity License

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.

Scientific Background

MetaWards implements a national-scale stochastic metapopulation model 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 (pre-print) 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, medRxiv 2020.02.12.20022566; DOI: 10.1101/2020.02.12.20022566

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 future development and scale-up of MetaWards can be robustly and efficiently conducted.

Getting help


Indices and tables