contagion

contagion is a Python package supporting node immunization and network contagion simulation

contagion is designed to be easy-to-use and full-featured, supporting computer scientists, public health researchers, network theorists, and more. Here are a few things we love about contagion:

• accessible interface for incorporating node immunization into contagion simulations
• supports immunization with delayed effect and variable immunity durations
• handles partial immunity and time-varying transmission rates
• can track symptom onset
• implements node testing policies (random, contact tracing)

Table of Contents

• Table of Contents
• Getting Started
• Documentation
• Example Usage
• Citing contagion
• Contributing to contagion
• Contact
• Requirements
• License

Getting Started

Install contagion with pip:

pip install contagion

Once contagion is installed, import NetworkX and contagion:

import networkx
from contagion import contagion

Documentation

Official documentation - including a tutorial, API reference, and a few worked examples - is available on Read the Docs.

Citing contagion

If you find contagion useful in your work, please use the Zenodo software citation.

Requirements

This project was created with:

• matplotlib==3.3.3
• numpy==1.19.3
• networkx==2.5
• scipy>=1.5.0
• seaborn==0.11.1

Contributing to contagion

We'd love your help! If you'd like to make an addition or improvement, please submit a pull request consisting of an atomic commit and a brief message describing your contribution. If you find something wrong, please submit a bug report to the issue tracker. For other questions or comments, feel free to contact me directly.

Thanks for helping make contagion better!

Contact

• Lucas McCabe (lucas.mccabe@jhu.edu)

License

MIT