Welcome to the Counterfactual Covid19 repository. This is a Leeds-Turing project that aims to visualise the counterfactual history of the growth of COVID-19 cases in Europe.

This repository contains two subdirectories:

• backend: This directory contains Django code that loads COVID-19 data from this repo and produces counterfactual simulations (the code for the counterfactual simulations is here).
• frontend: This directory contains react-leaflet code to visualise the COVID-19 data and counterfactual simulations based on this repo.

Both the frontend and the backend have their own set of prerequisites that you will need to install in order to run this app.

Ensure that the PostgreSQL database is running:

pg_ctl -D /usr/local/var/postgres start

Then run the Django backend from the backend/ directory with:

poetry run python3 manage.py runserver

followed by the React frontend from the frontend/ directory with:

npm start

The app should then be available at http://localhost:3000

Docker is the only prerequisite for the Dockerised version of the app.

Launch the app by running the following:

docker-compose up -d

This will create a series of persistent docker-compose images so that future runs will be faster to start up. Note that although npm reports several vulnerabilities, we are using the latest versions of all requested libraries - no security fixes are available.

To cleanup all images and force a full rebuild do

docker-compose down -v --rmi all --remove-orphans