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

Difference between revisions of "STEM"

(Advanced Guides)
(Next Release To Come October 22, 2014)
(369 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
[[Image:STEM TOP BAR.gif|800px]]
 
[[Image:STEM TOP BAR.gif|800px]]
  
The '''Spatio-Temporal Epidemiological Modeler (STEM)''' is a tool designed to help scientists and public health officials create and use models of emerging infectious diseases. STEM uses mathematical models of diseases (based on differential equations) to simulate the development or evolution of a disease in space and time (e.g., avian flu or salmonella). These models could aid in understanding, and potentially preventing, the spread of such diseases. STEM also comes pre-configured with a vast amount of reference or denominator data for the entire world. By using and extending the data and models in STEM it is possible to rapidly prototype and test models for emerging infectious disease. STEM also provides tools to help you compare and validate your models. As an open source project, the ultimate goal of STEM is to support and encourage a community of scientists that not only use STEM as a tool but also contribute back to it. STEM is designed so that models and scenarios can be easily shared, extended, and built upon.
+
{| align="right"
 +
  | __TOC__
 +
  |}
  
 +
== '''Ebola Community Efforts''' ==
 +
==== [[Weekly Community Ebola Modeling Phone Call]] ====
 +
==== [[Ebola Models]] ====
 +
==== [https://wiki.eclipse.org/Ebola_How_To How to install the Ebola models]====
 +
==== Literature [[Ebola References]]====
 +
==== Data [[Ebola Reference Data]]====
 +
==== Please sign up for the [https://dev.eclipse.org/mailman/listinfo/stem-ebola stem-ebola mailing list]====
  
== STEM Documentation ==
+
The '''Spatio-Temporal Epidemiological Modeler (STEM)''' is a tool designed to help scientists and public health officials create and use models of emerging infectious diseases. STEM uses mathematical models of diseases (based on differential equations) to simulate the development or evolution of a disease in space and time (e.g., avian flu or salmonella). These models could aid in understanding, and potentially preventing, the spread of such diseases. STEM also comes pre-configured with a vast amount of reference or denominator data for the entire world. By using and extending the data and models in STEM it is possible to rapidly prototype and test models for emerging infectious disease. STEM also provides tools to help you compare and validate your models. As an open source project, the ultimate goal of STEM is to support and encourage a community of scientists that not only use STEM as a tool but also contribute back to it. STEM is designed so that models and scenarios can be easily shared, extended, and built upon.
  
=== Introductory Resources ===
+
== '''STEM Documentation''' ==
  
*Full length STEM Tutorials on YouTube<sup>TM</sup>
+
<!--outer table-->{| style="width:98% ; border="0" ; cellpadding="0"
#[http://www.youtube.com/watch?v=LfiibQX4IFE In English]
+
<!--outer table-->|-
#[http://www.youtube.com/watch?v=AFYXvazKkms In Hebrew]
+
<!--outer table-->|
#[http://www.youtube.com/watch?v=NM5X8-MaiKo In Japanese]
+
{| style="width: 100%; height: 100%; background: #f1f5fc" ; border="0" ; cellpadding="5"
#[http://www.youtube.com/watch?v=3S5DbjCHsx4 In Spanish]
+
|- style="background: #cceeff"
 +
!
 +
=== Introductory Resources  ===
 +
|-
 +
|
 +
*[http://www.eclipse.org/stem/ The STEM Website]
 +
*[[About STEM]]
 +
*[[Whats New in STEM|What's New in STEM]]
 +
*STEM Tutorials on YouTube<sup>TM</sup>
 +
#[http://www.youtube.com/watch?v=MtQlS7g7Qnw STEM Model Generator (new!!)] ''requires STEM V2.0 milestone''
 +
#Full length video [http://www.youtube.com/watch?v=LfiibQX4IFE In English]  
 +
#Full length video [http://www.youtube.com/watch?v=AFYXvazKkms In Hebrew]  
 +
#Full length video [http://www.youtube.com/watch?v=NM5X8-MaiKo In Japanese]  
 +
#Full length video [http://www.youtube.com/watch?v=3S5DbjCHsx4 In Spanish]
 +
#[http://www.youtube.com/watch?v=OoiFLemepw4 5 min Video (English)]
  
*[http://www.youtube.com/watch?v=OoiFLemepw4 5 min Video (English)]
+
*[http://www.eclipse.org/stem/talksOnline.php Scientific Talks Online] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
*[http://www.eclipse.org/stem/talksOnline.php Scientific Talks Online]
+
*[[STEM FAQ|STEM FAQ]]  
*[http://www.eclipse.org/stem/ STEM Website]
+
*[[Publications and Presentations on STEM]]  
*[[About STEM]]
+
*[[Citing STEM]]  
*[[Whats New in STEM]]
+
*[[Join the STEM Community|How to Join the STEM Community]]
*[[STEM FAQ|STEM FAQ]]
+
*[[The STEM Development Team]]  
*[[Join the STEM Community]]
+
*[[Join the STEM Community|Weekly phone call]]
 +
 +
==== Getting Started ====
  
=== Getting Started ===
 
 
*[[Welcome STEM Developers]]
 
 
*[[STEM Installation Guide|Installing the STEM Application]]
 
*[[STEM Installation Guide|Installing the STEM Application]]
 +
*[[STEM Overview of the STEM UI|Overview of the STEM UI and menu items ''(new)'']]
 
*[[STEM Addons|Installing Additional Features]]
 
*[[STEM Addons|Installing Additional Features]]
*[[STEM Eclipse Setup|Setting up a STEM Development Environment]]
+
*[[Sample Projects available for Download|Sample Projects (Downloadable Scenarios)]]
*[[STEM Design Document]]
+
*[[Importing and Exporting Projects]]
*[[Sample Projects available for Download|Sample Projects Available for Download]]
+
*[[Analysis|Some Built in Tools for Analysis]]
*[[STEM National Language Support | National Language Support]]
+
*[[Context-Sensitive Help]]
 +
*[[STEM Model Creator|Using the '''''New!!''''' STEM Model Creator tool]] (''beta'')
  
=== Available Models ===
 
  
*[[Introduction to Compartment Models|Compartment Models]]
+
|}
*[[Available Models|Disease and Population Models]]
+
<!--inner table start-->|
*[[Transportation Models|Transportation Models]]
+
{| style="width: 100%; height: 100%; background: #f1f5fc" ; border="0" ; cellpadding="5"
*[[Air Travel Model|Air Travel Model]]
+
|-style="background: #cceeff"
*[[STEM_Solvers|Solvers]]
+
!
*[[Disclaimer]]
+
  
 
=== Tutorials ===
 
=== Tutorials ===
 +
|-
 +
|
 +
*'''[[Creating a STEM Scenario]]''' '''step by step'''
 +
*'''[[How_scenarios_are_structured| Scenario Structure: Tutorial with Templates]]'''
 +
#[[How_scenarios_are_structured#Template_for_a_Basic_Scenario_with_a_Human_Disease|Model with Human-Human Transmission]]
 +
#[[How_scenarios_are_structured#Template_for_a_Food_Borne_Disease_Scenario|Model of Food Borne disease]]
 +
*'''[[Initializing Disease Compartments|Initializing Diseases ''(Infectors, Inoculators, and Initializers)'']]'''
 +
*'''[[STEM Import Discrete Transportation Events|Import Discrete Transportation Events]]'''
 +
*'''[[Triggering interventions|Triggering Interventions]]'''
 +
#[[Triggering interventions#Social Distancing Example|Social Distancing Example]]
 +
#[[Triggering interventions#Vaccination Example|Vaccination Example]]
 +
#[[Triggering interventions#Evacuation Example|Evacuation Example]]
 +
#[[Triggering interventions#Air Transportation Example|Air Transportation Example]]
  
*[[Importing and Exporting Projects]]
+
*'''Using Population Models'''
*[[Creating a STEM Scenario]]
+
# [[Initializing a Population]]  
*[[How scenarios are structured]]
+
#[[Using Structured Populations in STEM|Using Structured Populations in STEM]]  
*[[Initializing a Population]]  
+
#[[Using Aging Populations in STEM|Using Aging Populations in STEM]]  
*[[Initializing Disease Compartments]]
+
 
*[[Using Structured Populations in STEM|Using Structured Populations in STEM]]  
+
*'''Running Simulations'''
*[[Using Aging Populations in STEM|Using Aging Populations in STEM]]  
+
#[[STEM_Map_View|The STEM Map View]]
*[[Batch Mode (Running Experiments)|Running Experiments in Batch Mode]]  
+
#[[Batch Mode (Running Experiments)|Running Experiments in Batch Mode]]  
*[[Running an Automated Experiment]]  
+
#[[Running an Automated Experiment]]  
*[[STEM Headless|Running STEM Headless]]  
+
#[[STEM Headless|Running STEM Headless]]
*[[Triggering interventions|Triggering Interventions]]  
+
#[[Importing Data from Files]]  
*[[Map|The STEM Map View]]  
+
#[[STEM Loggers|Simulation Data Logging]]
*[[Importing Data from Files]]  
+
#[[Visualizing STEM Simulations with Google Earth]]
*[[Logging Data to Files]]  
+
 
*[[Analysis|Analysis: Four Tools]]
+
*'''''(new)'' Automated Model Creation'''
*[[Context-Sensitive Help]]
+
#[[STEM Model Creator]] for users (''beta'')
 +
 
 +
|}
 +
<!--outer table-->|- style="width:45%"
 +
<!--outer table-->|
 +
{| style="width: 100%; background: #f1f5fc" ; border="0" ; cellpadding="5"
 +
|-style="background: #cceeff"
 +
!
  
 
=== Advanced Guides ===
 
=== Advanced Guides ===
 +
|-
 +
|
 +
====Developers====
 +
*[[Welcome STEM Developers]]
 +
*[[STEM Eclipse Setup|Setting up a STEM Development Environment]]
 +
*[[STEM Design Document]]
 +
*[[STEM National Language Support | National Language Support]]
 +
*[http://www.eclipse.org/projects/project.php?id=technology.stem Project Stats]
  
 
*[[Building the STEM RCP Application|Building the STEM RCP Application]]
 
*[[Building the STEM RCP Application|Building the STEM RCP Application]]
 
*[[Running STEM from the Development Environment]]
 
*[[Running STEM from the Development Environment]]
*[[Composing a Graph]]
+
*[[Creating a Customized Color Provider|Customizing Colors]]
*[[Creating a new Graph|Creating a Custom Graph]]
+
*[[STEM Performance Tips |General tips when writing performance critical code]]
*[[Visualizing and Editing Graphs]] with the STEM Graph Editor
+
*[[Importing a Pajek Graph|Importing a Graph from a Pajek File]]
+
*[[Creating a new Disease Model Plug-in|Creating a New Disease Model Plug-in Using EMF]]
+
*[[Creating a new disease label|Creating a New Disease Label]]
+
*[[Creating a Customized Color Provider]]
+
  
== [[Join the STEM Community]] ==
+
====Working with Graphs====
Click on [[Join the STEM Community]] to learn more about the STEM Community.
+
#[[Composing a Graph]]
 +
#[[Creating a new Graph|Creating a Custom Graph]] (''new'') ''seasonal migration''
 +
#[[Visualizing and Editing Graphs]] ''with the STEM Graph Editor  ''&nbsp;&nbsp;
 +
#[[Importing a Pajek Graph|Importing a Graph from a Pajek File]]
 +
#[[Importing an Esri Shapefile|Importing a Graph from an Esri Shapefile]]
  
== Eclipse Project Mentors ==
+
====Modeling New Diseases====
 +
#[[STEM Model Creator|Using the '''''New!!''''' STEM Model Creator tool]] (''beta'')
 +
#[[STEM Model Generator]] tool (for Developers)
 +
#*[[STEM_Model_Generator/Install|Model Generator Installation]]
 +
#[[Creating a new Disease Model Plug-in|Manual Model Plug-in generation]]
 +
#[[Creating a new disease label|Manual Disease Label creation]]
  
Our Eclipse Project Mentors are:
+
==== STEM Solvers ====
Ed Merks  mailto:ed.merks@gmail.com
+
*Available [[STEM_Solvers|Solvers]]
and
+
**STEM Native Solvers
Chris Aniszczyk  mailto:zx@eclipsesource.com
+
**Apache Common Math Solvers
 +
**Stochastic Solver
  
 +
=== Epidemiological Modeling ===
 +
|-
 +
|
 +
*[[Sample Projects available for Download|Sample Projects (Downloadable Scenarios)]]
 +
*[[Introduction to Compartment Models|Intro to Compartment Models]]
 +
*[[STEM Disease Models|Disease Models (basic to advanced)]]
 +
*[[STEM Population Models|Population Models]]
 +
#[[STEM_Population_Models#Standard_Population_Model|Standard Populations]]
 +
#[[STEM_Population_Models#Advanced_Models|Insect Vectors]]
 +
#[[STEM_Population_Models#Seasonal_Migratory_Population_Model|Migratory Birds]]
 +
#[[STEM_Population_Models#Multipopulation_Models|Demographic Models (and Aging)]]
 +
*[[STEM Food and Food Borne Disease|Food Borne Disease Models]]
 +
#[[Sample_Projects_available_for_Download#1._Beef_Production|Beef Production Example]]
 +
#[[Sample_Projects_available_for_Download#2._A_scenario_for_modelling_the_transmission_of_Salmonella_to_pigs.2C_pork_and_humans|Salmonella in Pork Example]]
 +
#[[How_scenarios_are_structured#Template_for_a_Food_Borne_Disease_Scenario|How to Structure a Food Borne Disease Scenario]]
 +
*[[Transportation Models|Transportation Models]]
 +
*[[Air Travel Model|Air Travel Model]]
  
[[Category:Eclipse Technology Project]]
+
|}
 +
{| style="width: 100%; height: 100%; background: #f1f5fc" ; border="0" ; cellpadding="5"
 +
|-style="background: #cceeff"
 +
!
  
== [[Publications and Presentations on STEM]]  ==
+
=== Release Planning ===
Click on [[Publications and Presentations on STEM]] to see a list of recent scientific publications and presentations describing research done with STEM.
+
|-
 +
|
 +
''Please also see our [http://www.eclipse.org/stem website]'' and [[Whats New in STEM|What's New in STEM]]  
  
== Future STEM Releases (Planned)  ==
+
====Next Release To Come January 30, 2015====
  
'''V1.3.0'''
+
====V2.0.2 Now Available====
Planned Date 1/29/2012
+
* Bug Fixes
Planned and Tentative Features:
+
* Updated Dengue Model and Scenario
 +
* New Campylobacter Scenario
  
* Ten years of Earth Science Data (2000-2010) available as STEM '''Features'''
+
====V2.0.1 Included====
* Malaria Disease Model (''Anopheles'' calibrated)
+
* Bug Fixes
* Dengue Fever Disease Model (''Aedes'' not yet calibrated)
+
* Updated Code Generator
* Additional NLS + User ability to switch languages
+
* New Campylobacter Model and Documentation
* Logger Framework with new loggers
+
* New Dengue Model and Scenario
* Shape File Import Utility (Dependency on Open Map CQ)
+
* Integrating external models for study of food based transmission
+
* New Differential Equation solver(s) from commons.math library
+
* Bug Fixes from 1.2.2
+
  
 +
====V2.0.0 Included====
 +
* Bug Fixes
 +
* Performance Improvements
 +
* New Stochastic Model Solver
 +
* Draggable Solver Objects 
 +
* Visual Editor (Integrated UI for creating new models of disease including domain specific language for epi modeling)
 +
* New Measles Model
 +
* Directionally Biased Mixing Model
 +
* New Model Generator (Makes it easy for domain experts to create new STEM Models--no programming required!!)
 +
* New Apache Library
  
 +
====...Future Features====
 +
* Running Distributed STEM
  
 +
====Release Engineering====
 +
STEM releases are created by the team of STEM committers and uploaded to Eclipse on a regular basis.
  
'''V1.3.1'''
+
Documentation for the process may be found on the [[STEM Releng]] page.
Tentative Date 1/15/2012
+
|}
Tentative Features:
+
* Bug Fixes to 1.3.0
+
* auto-documenting run parameters
+
* parameter sensitivity analysis
+
  
'''...future'''
+
<!--outer table-->|}
* Running Distributed STEM
+
  
 +
==[[Disclaimer]]==
  
{| align="right"
+
<br>
  | __TOC__
+
 
  |}
+
[[Category:Eclipse Technology Project]]
 +
 
 +
Click on the header for this section to view the Disclaimer.

Revision as of 11:26, 29 January 2015

STEM TOP BAR.gif

Ebola Community Efforts

Weekly Community Ebola Modeling Phone Call

Ebola Models

How to install the Ebola models

Literature Ebola References

Data Ebola Reference Data

Please sign up for the stem-ebola mailing list

The Spatio-Temporal Epidemiological Modeler (STEM) is a tool designed to help scientists and public health officials create and use models of emerging infectious diseases. STEM uses mathematical models of diseases (based on differential equations) to simulate the development or evolution of a disease in space and time (e.g., avian flu or salmonella). These models could aid in understanding, and potentially preventing, the spread of such diseases. STEM also comes pre-configured with a vast amount of reference or denominator data for the entire world. By using and extending the data and models in STEM it is possible to rapidly prototype and test models for emerging infectious disease. STEM also provides tools to help you compare and validate your models. As an open source project, the ultimate goal of STEM is to support and encourage a community of scientists that not only use STEM as a tool but also contribute back to it. STEM is designed so that models and scenarios can be easily shared, extended, and built upon.

STEM Documentation

Introductory Resources

  1. STEM Model Generator (new!!) requires STEM V2.0 milestone
  2. Full length video In English
  3. Full length video In Hebrew
  4. Full length video In Japanese
  5. Full length video In Spanish
  6. 5 min Video (English)

Getting Started


Tutorials

  1. Model with Human-Human Transmission
  2. Model of Food Borne disease
  1. Social Distancing Example
  2. Vaccination Example
  3. Evacuation Example
  4. Air Transportation Example
  • Using Population Models
  1. Initializing a Population
  2. Using Structured Populations in STEM
  3. Using Aging Populations in STEM
  • Running Simulations
  1. The STEM Map View
  2. Running Experiments in Batch Mode
  3. Running an Automated Experiment
  4. Running STEM Headless
  5. Importing Data from Files
  6. Simulation Data Logging
  7. Visualizing STEM Simulations with Google Earth
  • (new) Automated Model Creation
  1. STEM Model Creator for users (beta)

Advanced Guides

Developers

Working with Graphs

  1. Composing a Graph
  2. Creating a Custom Graph (new) seasonal migration
  3. Visualizing and Editing Graphs with the STEM Graph Editor   
  4. Importing a Graph from a Pajek File
  5. Importing a Graph from an Esri Shapefile

Modeling New Diseases

  1. Using the New!! STEM Model Creator tool (beta)
  2. STEM Model Generator tool (for Developers)
  3. Manual Model Plug-in generation
  4. Manual Disease Label creation

STEM Solvers

  • Available Solvers
    • STEM Native Solvers
    • Apache Common Math Solvers
    • Stochastic Solver

Epidemiological Modeling

  1. Standard Populations
  2. Insect Vectors
  3. Migratory Birds
  4. Demographic Models (and Aging)
  1. Beef Production Example
  2. Salmonella in Pork Example
  3. How to Structure a Food Borne Disease Scenario

Release Planning

Please also see our website and What's New in STEM

Next Release To Come January 30, 2015

V2.0.2 Now Available

  • Bug Fixes
  • Updated Dengue Model and Scenario
  • New Campylobacter Scenario

V2.0.1 Included

  • Bug Fixes
  • Updated Code Generator
  • New Campylobacter Model and Documentation
  • New Dengue Model and Scenario

V2.0.0 Included

  • Bug Fixes
  • Performance Improvements
  • New Stochastic Model Solver
  • Draggable Solver Objects
  • Visual Editor (Integrated UI for creating new models of disease including domain specific language for epi modeling)
  • New Measles Model
  • Directionally Biased Mixing Model
  • New Model Generator (Makes it easy for domain experts to create new STEM Models--no programming required!!)
  • New Apache Library

...Future Features

  • Running Distributed STEM

Release Engineering

STEM releases are created by the team of STEM committers and uploaded to Eclipse on a regular basis.

Documentation for the process may be found on the STEM Releng page.

Disclaimer


Click on the header for this section to view the Disclaimer.

Back to the top