Episimmer : Epidemic Simulation Platform

Powered by HealthBadge

Episimmer is an Epidemic Simulation Platform. It aims to provide Decision and Recommendation Support to help answer your questions related to policies and restrictions during an epidemic. Using simulation techniques widely applied to other fields, we can help schools and colleges discover and hone the opportunities and optimizations they could make to their COVID-19 strategy. From the most simple decisions(Which days to be online or offline) to more complex strategies(What restrictions should I put on library use?, How many times should I test?, Whom do I test?) Episimmer is the tool for the job.

Here is a short video describing Episimmer : Video link

Installation

Run the following command in the local repository after cloning or downloading the repository

	pip install -e .

Running Examples

To run examples :

	python episimmer/main.py <Path_to_Example>

Flags :

	-np or --noplot : Restrict plotting the time plot after simulation. Default = False
	-vul or --vuldetect : Run Vulnerability Detection on the data folder based on VD_config.txt. Default = False
	-a or --animate : Creates a gif animation of the time plot. Default = False
	-s or --stats : Choose to store statistics. Default = False
	-viz or --vizdyn : Creates a gif of the simulation environment progressing through the days. Default = False

Getting started

You can start using Episimmer by using the following tutorials :

Tutorial 1 : Getting started with Episimmer
Tutorial 2.0 : Episimmer Basic Modelling Theory
Tutorial 2.1 : Modifications to the compartment model
Tutorial 2.2 : Modifications to interaction spaces
Tutorial 3 : Introduction to Intervention and Policy

UI

Our current UI can be found at https://episimmer.herokuapp.com/. Note that it has minimal functionality as compared to running the codebase directly. Yet it competes with the current state of the art systems with multiple novel features.

Episimmer is currently Work in Progress. Check out these point solutions built using the Episimmer codebase.

• Optimizing Lockdowns
  
• Efficient Contact tracing
  
• YACHT protocol
  
• Custom Stochastic Model on a complete graph
  
• Testing strategies (Pool testing, Friendship testing)
  
• Vaccination with multiple vaccine types