Skip to main content

Simulate the spread of COVID-19 with different policies.

Project description

PyPI PyPI - Python Version https://img.shields.io/conda/vn/conda-forge/sid-dev.svg https://img.shields.io/conda/pn/conda-forge/sid-dev.svg PyPI - License https://readthedocs.org/projects/sid-dev/badge/?version=latest https://img.shields.io/github/workflow/status/covid-19-impact-lab/sid/Continuous%20Integration%20Workflow/main https://codecov.io/gh/covid-19-impact-lab/sid/branch/main/graph/badge.svg pre-commit.ci status https://img.shields.io/badge/code%20style-black-000000.svg

Features

sid is an agent-based simulation model for infectious diseases like COVID-19. It scales from simple examples to complex models which makes it an ideal tool for prototyping, educational purposes, and research.

sid’s focus is on predicting the effects of non-pharmaceutical interventions on the spread of an infectious disease. To accomplish this task it is built to capture important aspects of contacts between people. In particular, sid has the following features:

  1. At the core of the model, people meet people based on a matching algorithm. It is possible to represent a variety of contact types like households, leisure activities, school classes and nurseries with teachers and several types of contacts at the workplace. Contact types can be random or recurrent and vary in frequency.

  2. Policies allow to shut down contact types entirely or partially. The reduction of contacts can be random or systematic, e.g., to allow for essential workers.

  3. Infection probabilities vary across contact types and depending on the age of the susceptible individual, but are invariant to policies which reduce contacts. The invariance is an essential property for predicting the effects of policies for which empirical data does not exist.

  4. The model achieves a good fit on German infection and fatality rate data even if only the infection probabilities are fit to the data and the remaining parameters are calibrated from the medical literature and data on contact frequencies.

  5. The model allows for two testing mechanisms, representing PCR and rapid tests. PCR tests always reveal the true health status of the tested individual after some days which can be used for testing policies or to differentiate between known and unknown infections.

    In contrast, rapid tests immediately return the test outcome and identify infected people based on the sensitivity and specificity of the test. It is possible to implement reactions to the outcome of the test enabling individuals to plan meetings, test with a rapid test, and to refrain from meeting if the test is positive.

  6. Mutations may lead to multiple, prevalent virus strains with different characteristics. For now, sid is able to model an unlimited amount of virus strains with different degrees of infectiousness.

  7. It is possible to implement models for vaccinating people who, then, gain perfect immunity from the disease.

More information can be found in the discussion paper or in the documentation.

Installation

sid is available on PyPI and on Anaconda.org and can be installed with

$ pip install sid-dev

# or

$ conda install -c conda-forge sid-dev

Publications

sid has been featured in some publications which are listed here:

Citation

If you rely on sid for your own research, please cite it with

@article{Gabler2020,
  Title = {
    People Meet People: A Microlevel Approach to Predicting the Effect of Policies
    on the Spread of COVID-19
  },
  Author = {Gabler, Janos and Raabe, Tobias and R{\"o}hrl, Klara},
  Year = {2020},
  Publisher = {IZA Discussion Paper}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sid_dev-0.0.10.tar.gz (67.4 kB view hashes)

Uploaded Source

Built Distribution

sid_dev-0.0.10-py3-none-any.whl (73.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page