Skip to main content

A tool for modeling infectious diseases.

Project description


latest-release conda Downloads Language grade: Python Total alerts lines of code open-issues build-status

A tool for creating and testing compartmental epidemiological models faster than ever for the mathematical modeling of infectious diseases. An idea from

epi-spot social image

DOI Information

Use epispot's DOI in your research! :fireworks:


q9i, & QLabs. (2021, April 2). epispot/epispot: (Version 2.1.0). Zenodo.

Current Build Statuses

Workflow Status
build.yml GitHub Workflow Status
coverage.yml GitHub Workflow Status
python-publish.yml latest-release
codeql-analysis.yml GitHub issue custom search in repo


Epispot can be installed via pip or via Anaconda. If using pip, install with:

pip install epispot

For Anaconda, install via conda-forge as:

conda config --add channels conda-forge
conda install -c conda-forge epispot

As a shorthand, use import epispot as epi.

You can also install the epispot-nightly package from pip:

pip install epispot-nightly

You can import it the same as import epispot as epi. Both packages cannot be used at the same time.

Getting Started

Start with the tutorials in tests/tutorials (see GitHub repo). Next, check out the documentation at You may also find it helpful to see the examples in the tests/examples folder.

Release Notes

See GitHub repo for more info.


  • SIR-based models

    • Susceptible
    • Infected
    • Recovered
    • Exposed
    • Dead
    • Critical
    • Hospitalized
  • Custom-defined compartmental models

    • Create custom models using the Model class
  • Graphing Capabilities

    • Plot real data from a .csv file
    • Plot model predictions interactively
    • Compare different model predictions

A Note on Documentation

Documentation can easily be accessed from function, class, and file docstrings. Docstrings provide additional documentation on a certain function. They can be accessed by the built-in Python help() command. These strings are formatted in Github-flavored markdown. Additionally, all files will have a 'STRUCTURE' label.


The epispot package is supported by the following contributors:

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

epispot-2.1.0.tar.gz (17.2 kB view hashes)

Uploaded source

Built Distribution

epispot-2.1.0-py3-none-any.whl (28.9 kB view hashes)

Uploaded 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