Covasim Webapp

Covasim is a stochastic agent-based simulator designed to be used for COVID-19 (novel coronavirus, SARS-CoV-2) epidemic analyses. These include projections of indicators such as numbers of infections and peak hospital demand. Covasim can also be used to explore the potential impact of different interventions, including social distancing, school closures, testing, contact tracing, quarantine, and vaccination.

The scientific paper describing Covasim is available at http://paper.covasim.org. The recommended citation is:

Kerr CC, Stuart RM, Mistry D, Abeysuriya RG, Hart G, Rosenfeld R, Selvaraj P, Núñez RC, Hagedorn B, George L, Izzo A, Palmer A, Delport D, Bennette C, Wagner B, Chang S, Cohen JA, Panovska-Griffiths J, Jastrzębski M, Oron AP, Wenger E, Famulare M, Klein DJ (2020). Covasim: an agent-based model of COVID-19 dynamics and interventions. medRxiv 2020.05.10.20097469; doi: https://doi.org/10.1101/2020.05.10.20097469.

The Covasim webapp is available at http://app.covasim.org.

Note that this repository is the code for the webapp only. The main Covasim repository is available at https://github.com/InstituteforDiseaseModeling/covasim. Most users will want to use the main Covasim repository, or access the webapp using the link above. This repository is only needed if you are a developer and wish to run the webapp locally.

Questions or comments can be directed to us at covasim@idmod.org, or on this project's GitHub page. Full information about Covasim is provided in the Covasim documentation.

Contents

• Requirements
• Quick start guide
• Docker
• Disclaimer

Requirements

Python >=3.6 (64-bit). (Note: Python 2 is not supported.)

We also recommend, but do not require, using Python virtual environments. For more information, see documentation for venv or Anaconda.

Quick start guide

1. Clone a copy of this repository:

git clone https://github.com/InstituteforDiseaseModeling/covasim_webapp

2. Navigate to the root of the repository and install the Covasim Webapp Python package:

python setup.py develop

3. Change to package folder and run the application via Flask:

cd covasim_webapp
python cova_app.py

4. Go to localhost:8188 in your browser to view the webapp.

See the webapp README for more information.

Docker

This folder contains the Dockerfile and other files that allow Covasim to be run as a webapp via Docker. See the Docker README for more information.

Disclaimer

The code in this repository was developed by IDM to support our research in disease transmission and managing epidemics. We’ve made it publicly available under the Creative Commons Attribution-ShareAlike 4.0 International License to provide others with a better understanding of our research and an opportunity to build upon it for their own work. We make no representations that the code works as intended or that we will provide support, address issues that are found, or accept pull requests. You are welcome to create your own fork and modify the code to suit your own modeling needs as contemplated under the Creative Commons Attribution-ShareAlike 4.0 International License.