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 git@github.com:simoninireland/epydemic.git
cd epydemic
pip install .

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

Copyright (c) 2017-2024, Simon Dobson <simoninireland@gmail.com>

Licensed under the GNU General Public Licence v3.