Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

2019 novel Corona Virus Model

Revision as of 00:27, 31 January 2020 by Jhkauf.gmail.com (Talk | contribs) (Acknowledgements)

STEM TOP BAR.gif

This page is under construction

The 2019 novel Corona Virus Model is an all in one archive available on the download page that allows you to install and run a global model to study 2019-nCoV.

Please Observe: The correct epidemiological parameters are not known at this time.


Documentation relevant to installing and running the model

Please see the following wiki pages for help

  1. Importing and Exporting Projects
  2. using the The STEM UI and Map View
  3. setting up Simulation Data Logging
  4. Triggering interventions

Archive and it's contents

Please visit the downloads page and download the single archive. Extract the archive to your local file system. It contains four primary components.

ProjExplorerCoronaV.png

All four of these components must be imported directly into your STEM work space (not nested in another folder). If you already have the GlobalGeography or the SuperContinentExamples projects installed you need not reinstall them (but they are required to run the scenario).

  • The project ncov.eclipse.org.coronavirus is the model builder project containing the disease model.
  • Project folder CoronaVirus contains the global scenario.

Setting up the model

Once you have installed all four projects and can see them all, un-nested, in the project explorer (in your workspace),

  1. navigate to the ncov.eclipse.org.coronavirus
  2. open the models folder.
  3. make sure you are in the designer perspective
  4. double click on coronavirus.metamodel

you should the see the compartment model itself as shown below.

NCoV model.png

The nCoV model is an SAIR model where A represents individuals who are shedding virus (infectious) but asymptomatic. The I compartment represents individuals who are infectious and symptomatic. The incidence (or transition from S -> A, depends on the sum of the fraction infectious in both A and I. Click on the transition and see the expression in the expression editor. You can watch the youtube video on the model builder to see how this works.

The model looks a lot like an SEIR model but there is no incubation state (E) or incubation rate (you could add that if you want to). The reason to explicitly model the A compartment is that one can add interventions (predicates, modifiers, and triggers) based on the I state but not A. The rate individuals move from A -> I is called the "Symptom Appearance Rate" in this model. Next,

  • Navigate to the CoronaVirus project,
  • open the decorators folder,
  • and double click on the disease model (not the infector) to open it in the resource window.
  • Click on it in that window and open the property view below.

You should see all the parameter values defined in this model as shown in the image below.

NCoV Params.png

Precise values are not known at this time. The settings used in the downloadable scenario are based on upper estimates for the basic reproductive number reported in the literature as of Jan 30, 2020. Ro depends on the transmission rate, β , the recovery rate, γ , and the infectious mortality rate, μ .

Ro = β/[γ + μ]

With the values shown above this puts Ro ~ 3.4. The first case appeared in mid December 2019. If you run the simulation for 45 days you will see the current settings over estimate cases in China but under estimate incidence from air travel. The high end estimate for Ro is likely too high and the build in STEM air travel model probably underestimates recent traffic.

Running the model (for the first time)

Before you try to run the model, navigate to the command bar ....

  • Preferences>STEM>Simulation Management
  • uncheck scenario caching
  • set the time delay to about 150 msec

Then navigate to

  • Preferences>STEM>Solver
  • and increase worker threads if you workstation has more than two core (for example 4 threads will help performance).

Remember you are about to load a global simulation.

  • Open the Scenarios folder
  • Select the GlobalCoronaVirusScenario.scenario Scenario.
  • Right click and click STEP the little foot step icon. (please do not click run yet)
  • Depending on your laptop you might want to get a cup of coffee. It will take a couple of minutes to load.

Once the map loads you can pan by clicking and draging the map and zoom with up and down arrows.

  • Right click on the ocean and select a gain factor of 1,000,000
  • Step a few more times until you are at about day 4
  • Zoom in on China until you can find the red administrative zone where the infector seeded the first case(s). This is Wuhan Shiqu (Wuhan City).
  • Double click on Wuhan to start a time series monitor for that region.

FindWuHan2.png

  • Zoom and Pan until you find San Francisco in California, and double click to set up a monitor for that region.

FindSFO.png

  • Right click on the map again and set the gain factor down to 1000. This is high enough to see the early cases.
  • Click "run"
  • When you get to about 40 days you might hit pause and then step again until you see evidence for infection via air travel.

Once you have the scenario running, go back to the property view for the disease model and see how changing the parameters effects the spread. You might also add interventions and create a logger to study how the asymptomatic cases affect possible intervention strategies.


Acknowledgements

The STEM community would like to acknowledge Dr. Brian M. Gurbaxani(CDC/DDPHSS/OS/OTI) for suggesting the structure of this model.

Back to the top