This is WIP. Anything wrong or missing? Please improve and open a PR!
The following papers are relevant to the model. Please note that some of them may require a subscription to the appropriate publication to read.
- https://www.imperial.ac.uk/media/imperial-college/medicine/sph/ide/gida-fellowships/Imperial-College-COVID19-NPI-modelling-16-03-2020.pdf
- https://www.nature.com/articles/nature04795
- https://www.nature.com/articles/nature04017
- https://www.pnas.org/content/105/12/4639.short
This is a spatial model. We divide a country into cells and microcells (9x9 microcells to a cell) which are geolocated.
People are allocated according to population density data (from input files) to cells. People have an age, and other attributes. People's residence location does not change, but they interact with people in other cells via places (see below) and via random social interactions governed by a spatial kernel function.
People are assigned to places (institutions such as households, offices, schools etc.) that have a geographical location. Place groups which divides places into compartments (the intent here is that you're less likely to be infected by someone in the same office but who works on a different floor).
People don't move. Instead the simulation employs spatial mixing probability distributions (spatial kernels) that control the probability that people in cell X will infect people in cell Y located in another spatial region.
Infections may be initially seeded in different ways. The simplest way is to seed according to population density (but seeds can be from specific places, or randomly etc.)
InfectSweep
is the main function where infections spread. It loops over people and transmits infections by calculating a FOI (force of infection). Infection-spreading is divided into 3 transmission mechanisms:
- household infections (e.g. between family members)
- place infections (e.g. at work)
- spatial infections (e.g. when travelling around)
Spatial infection models contacts between individuals which have a frequency which depends upon the distance between home locations (to avoid literally moving people around cells), modelled using a kernel function that weights according to both spatial distance and population densities.
For more information on the model and associated interventions, please visit:
- https://www.imperial.ac.uk/media/imperial-college/medicine/sph/ide/gida-fellowships/Imperial-College-COVID19-NPI-modelling-16-03-2020.pdf
- https://www.nature.com/articles/nature04795
- https://www.nature.com/articles/nature04017
- https://www.pnas.org/content/105/12/4639.short
Please note that some of the above may require a subscription.