Enable javascript in your browser for better experience. Need to know to enable it? Go here.
Close
EpiRust
EpiRust

EpiRust

Open Source Insights Back

What is EpiRust?

 

EpiRust is an open-source, fast, agent-based simulation framework to model epidemics in large-scale cities. Using this framework, researchers can model diseases like smallpox, H1N1 and now COVID-19. A researcher can simulate a disease model for a city with a population of up to a few million agents using commodity hardware like laptops and desktops.

 

 

Why choose EpiRust? 

 

To analyze and predict a pandemic such as COVID-19's behavior is a complex task. Pandemics are rare and have few historical references. The last pandemic that is similar to what is happening now, occurred over a century ago and that era's data is so thin and barely useful. Additionally, every pandemic could have numerous unique and local characteristics – based on demographics, local climate and the disease itself.

 

As a pandemic starts unfolding, public health policy makers have limited time to assess the risk and prepare a response strategy. Such a response strategy must adapt to an evolving situation, involve various what-if and if-what scenarios.

 

Historically, policy makers relied on their own experience, skills and imagination to describe these scenarios. Such descriptions were often implicit and informal. Today, computer simulations help bridge this gap and aid in the development of response strategies. They perform what-if experiments to understand the spread of new pathogens and optimize interventions based on available resources. The success of such simulations lies in the right choice of modeling approaches and their scale. 

 

Our simulation allows a researcher to introduce a pathogen into a virtual society and observe the disease’s spread under various circumstances – when people go to work, under lockdowns and so on.

The EpiRust model

A depiction of Epirust, the large-scale, agent-based epidemic simulation frameworks developed in India. It follows a minimalist approach for modeling an epidemic in a virtual society along three main aspects – population, geography and disease. An agent (a person in the population) is initialized into the virtual society based on whether they work or stay at home, whether they use public transport and more. The model mimics a city’s geography by allocating places on a grid for home, workplace and transport. This shows how the rates of infection change with mobility. All the agents are treated as susceptible to the disease. Their status changes when they are exposed to the infection, fall ill and either recover or succumb to it. The model also accounts for external interventions like lockdowns, isolation and vaccination.
A depiction of Epirust, the large-scale, agent-based epidemic simulation frameworks developed in India. It follows a minimalist approach for modeling an epidemic in a virtual society along three main aspects – population, geography and disease. An agent (a person in the population) is initialized into the virtual society based on whether they work or stay at home, whether they use public transport and more. The model mimics a city’s geography by allocating places on a grid for home, workplace and transport. This shows how the rates of infection change with mobility. All the agents are treated as susceptible to the disease. Their status changes when they are exposed to the infection, fall ill and either recover or succumb to it. The model also accounts for external interventions like lockdowns, isolation and vaccination.

Grid-based geography similar to a minimalist planned city

 

EpiRust follows a minimalist approach for modeling an epidemic in a virtual society along four main aspects – population, geography, disease and interventions.

 

Population - an agent represents a person in a population. Agents are heterogeneous along two attributes namely work status (via working and non-working) and transport preference for office commute (via public transport and private transport). A fraction of the working population can be configured as the essential workers whose services are available even when the other agents have restrictions on their movements.

 

Geography - the EpiRust model mimics the geography of a minimalist city and represents it as a grid with various planned functional areas for homes, workplaces and transportation.

 

Disease dynamics - the current disease dynamics is based on the Mordecai SEIR model (Childs et al., 2020) and is specialized for COVID-19 similar to (Snehal Shekatkar et al., 2020). 

 

Interventions - interventions play a key role in devising policies to reduce and eventually to stop the spread of an epidemic. EpiRust has support for three interventions namely isolation via hospitalization, lockdown of the city and mass vaccination.

 

For more on EpiRust, read the paper here.

 

Using the framework

 

  1. Information on the set up

     

  2. Information on configuration

     

Citing the simulation model

 

Kshirsagar, J. K., Dewan, A.; Hayatnagarkar, H. G. (2021). Epirust: Towards a framework for large-scale agent-based epidemiological simulations using Rust language. Linköping Electronic Conference Proceedings. https://doi.org/10.3384/ecp20176475

 

Contact us at epirust@thoughtworks.com

We are committed to Open Source

Learn more

Thoughtworks acknowledges the Traditional Owners of the land where we work and live, and their continued connection to Country. We pay our respects to Elders past and present. Aboriginal and Torres Strait Islander peoples were the world's first scientists, technologists, engineers and mathematicians. We celebrate the stories, culture and traditions of Aboriginal and Torres Strait Islander Elders of all communities who also work and live on this land. 

 

As a company, we invite Thoughtworkers to be actively engaged in advancing reconciliation and strengthen their solidarity with the First Peoples of Australia. Since 2019, we have been working with Reconciliation Australia to formalize our commitment and take meaningful action to advance reconciliation. We invite you to review our Reconciliation Action Plan.