Skip to main content

Epidemic network simulations in Python

Project description


epydemic is a Python library that implements simulations of epidemic (and other) processes on networks. Epidemic processes are very important in both network science and its applications. The most common application is to study the ways in which diseases progress in different network conditions, depending on their infectiousness and other properties, but epydemic can be used to study any network processes of interest.

epydemic provides simulation under synchronous and stochastic (Gillespie) dynamics, using the well-known networkx package to represent and manipulate networks. It supports a generic model for compartmented models of disease with several standard models provided and which can be extended to other, more complex, diseases. It also supports other network processes such as addition-deletion networks and pulse-coupled synchronisation, generators for several different ensembles of random networks, and a library for handling generating functions used in network analysis.

epydemic is built on top of the epyc experiment management library, allowing simulations to be conducted at scale on individual machines, multicore machines, and parallel computing clusters.


You can install epydemic directly from PyPi using pip:

pip install epydemic

The master distribution of epydemic is hosted on GitHub. To obtain a copy, just clone the repo:

git clone
cd epydemic
pip install .


API documentation for epydemic is available on ReadTheDocs (please note the slightly different project name).

Author and license

Copyright (c) 2017-2022, Simon Dobson <>

Licensed under the GNU General Public Licence v3.

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

epydemic-1.13.1.tar.gz (98.9 kB view hashes)

Uploaded source

Built Distribution

epydemic-1.13.1-py2.py3-none-any.whl (114.1 kB view hashes)

Uploaded py2 py3

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