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.6.tar.gz (65.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sid_dev-0.0.6-py3-none-any.whl (70.6 kB view details)

Uploaded Python 3

File details

Details for the file sid_dev-0.0.6.tar.gz.

File metadata

  • Download URL: sid_dev-0.0.6.tar.gz
  • Upload date:
  • Size: 65.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5

File hashes

Hashes for sid_dev-0.0.6.tar.gz
Algorithm Hash digest
SHA256 7561699f3d7fe5b38f1457ea429684ace5fcbd37f627b1612813e870229480ad
MD5 c04d8bd52fd67fe9c72465bc12183a27
BLAKE2b-256 f0403421ec8624c49a50aa048183c2d09c86a30a142b68af8bc9f734873aeeff

See more details on using hashes here.

File details

Details for the file sid_dev-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: sid_dev-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 70.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5

File hashes

Hashes for sid_dev-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 360b212a8819f53abe3a964e738391f688c1b94e7693269b6d3c5ddaf80c9ac1
MD5 9ac3afc1d088cc8b6438bd2ff8a87dd2
BLAKE2b-256 a01eee789c752e9d56d5d39d141a36d61740e0f4822423642b46311c2bd63a60

See more details on using hashes here.

Supported by

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