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 FAQ"

(What is the STEM project release schedule?)
 
(55 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==What is the STEM project release schedule?==
+
[[Image:STEM TOP BAR.gif|800px]]
  
Release 0.3.0 was released on September 9th, 2008, (Windows only)
+
{| align="right"
Release 0.2.0 was released on June 8th, 2007.
+
|-
Release 0.2.1 was released on December 17th, 2007.
+
| __TOC__
 +
|}
  
This includes the current STEM source code and downloadable executables for Windows, Linux and Mac OS X.
+
'''[http://wiki.eclipse.org/STEM Back]'''
  
==What platforms are supported?==
+
== Where should I start? ==
 +
To learn about how to use STEM, please read the [[STEM#STEM_Documentation | Tutorials]]
  
In theory, STEM will run on any platform supported by Eclipse.  The current downloads are for RCP versions of Windows, Linux, and Mac OSX.  Note that Java 1.6 is required for MacOS.
+
The most important tutorial is probably the one that teaches about [[Creating a STEM Scenario]]
  
If a downloadable RCP version is not available for your platform, you must download the STEM source from CVS and run from the source.
+
To learn about the design of STEM, please read the [[STEM Design Document]]
  
==What are the features of release 0.3.0?==
+
== What platforms are supported? ==
  
* Experiments. An Experiment is a combination of a Scenario and a set of Modifiers. A Modifier is a definition of how to systematically change the value of some element of a Scenario in a specific manner. The intent is to be able to specify how to create a sequence of derivative Scenarios from the base Scenario referenced by the Experiment. These derivative Scenarios are created by applying the Modifiers to the base Scenario.  An Experiment can be executed like Scenario creating a Batch which then spawns off separate Simulations from each of the derivative Scenarios.  Currently, the Simulations in a Batch are run sequentially. Parallel execution is planned for a future release.
+
STEM will run on any platform supported by Eclipse. Downloads are available for RCP versions of Windows, Linux, and Mac OSX. Java 1.6 and the latest is required. The STEM development environment requires the latest version of Eclipse. If a downloadable RCP version is not available for your platform, you must download the STEM source from Eclipse and run from the source.
  
* A preliminary implementation of Triggers (Predicate & Action).  A Trigger is a combination of a Boolean Predicate and an Action.  At each cycle in the simulation, if the Boolean expression is True, then the Action is "triggered".  An action is a "Modifier" and can change arbitrary components of a running simulation including things like the values of labels in the graph (e.g., to close an airport) or the parameters of a disease model.  Currently, the predicates are limited to testing the absolute or elapsed time value.  This limitation will be removed in a future release.
+
== What features are new? ==
  
* Various improvements to the visualizations including display of the graph edges
+
Please see [https://wiki.eclipse.org/index.php/STEM  What's New in STEM]
 +
<br>
  
* A new Analysis Perspective
+
== What are other features are available in STEM? ==
  
The Analysis and Validation Perspective is a new STEM Perspective that supports a variety of analysis, fitting, and comparison functions across multiple simulations and data sets.  
+
*A full implementation of the STEM graph based simulation engine for [http://www.google.com/search?hl=en&q=spatiotemporal%20 spatiotemporal] modeling
  
 +
*Geographic visualization of the spread of disease using internally implemented graphics
 +
*Geographic visualization of the spread of disease using [http://earth.google.com/ Google Earth]
 +
*"Wizards" to create Projects, Graphs, Models, Scenarios, Sequencers, and Diseases
 +
*Visual editors to edit Graphs, Models, Scenarios, Sequencers, and Diseases
  
'''Model Parameter Estimation View'''
+
*A complete data set that defines all of the countries specified by the [http://en.wikipedia.org/wiki/ISO_3166 ISO-3166 standard] includes area land mass and recent human population data
  
Given a set of data (SI, SIR, or SEIR) as a function of time, this perspective provides an estimation of the model parameters for a standard compartment model of the corresponding type. The view provides estimates for:
+
*A complete Lat/Long data set in [http://en.wikipedia.org/wiki/Geography_Markup_Language Geography Markup Language] (GML) format for all countries defined by the [http://en.wikipedia.org/wiki/ISO_3166 ISO-3166 standard]
  
beta, the disease transmission rate
+
*An extensive set of predefined "Graph" fragments that can be reused in user Models
alpha, the recovery rate
+
*An extensive set of predefined "Models", one for each country, that can be reused in user Models and Scenarios
epsilon, the incubation rate
+
*A set of predefined "Scenarios" that illustrate disease spread models around the Earth
gamma,the immunity loss rate
+
*A wide variety of mathematical models of infectious disease
 +
*Lots more. We are adding features all the time
  
 +
== What features are planned for future releases? ==
  
'''Dynamical Systems View (Lyapunov Analysis)'''
+
For the latest release and plan information, please visit the [http://www.eclipse.org/projects/project-plan.php?projectid=technology.stem STEM Project Plan Page]
  
This view displays the rate of separation in phase space (I vs. S) of the trajectories representing two different data sets or disease models. The rate of separation is then plotted vs time in a second chart. The rate of spread of any infectious disease defines a dynamical system. The Lyapunov exponent of any dynamical system describes the rate of separation of infinitesimally close trajectories in phase space.
+
== Can STEM be used for more than just disease modeling? ==
  
 +
In principle, yes. The core components of STEM implement a graph based spatiotemporal simulation engine. The components that extend it to disease modeling are in separate plug-ins and integrate themselves using Eclipse extension points. Today we are focused on supporting a framework for modeling diseases. In order to model diseases one must also model populations, transportation, etc. So STEM is really a way to build models on top of other models. Some models, like models of insect vectors, may depend on global data including things like climate factors. All this "denominator" data is available as STEM plugins. Some users have build higher level economic models on top of disease models in STEM.
  
'''Cross Model Comparison (RMS compare)'''
+
== Where can I find some tutorials on STEM? ==
  
Given a data set and the results of a model (or two model generated data sets), the Root Mean Square (RMS) comparison function shows the RMS difference between the two as a function of time.
+
*[[STEM#STEM_Documentation | Tutorials for Developers]]
 +
*STEM Tutorials on YouTube<sup>TM</sup>
 +
#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.eclipse.org/stem/talksOnline.php Scientific Talks Online]
  
+
== Where can I learn about the design of STEM? ==
'''The Epidemic View'''
+
  
This view displays the aggregated data (e.g.,  S,E,I,R, births, and deaths) as a function of time. It also creates a summary file integrating over the data from all locations in a previously run scenario. It also shows the incidence or "newly infectious count" for the aggregated data.
+
[[STEM Design Document]]
  
==What are the features of release 0.2.0?==
+
== Are there publications where I can read more about STEM ? ==
  
* A full implementation of the STEM graph based simulation engine for [http://www.google.com/search?hl=en&q=spatiotemporal%20 spatiotemporal] modeling
+
[http://wiki.eclipse.org/STEM#Publications_and_Presentations_on_STEM Publications and Presentations on STEM]
  
* Geographic visualization of the spread of disease using internally implemented graphics
+
== How can I contribute to STEM ? ==
* Geographic visualization of the spread of disease using [http://earth.google.com/ Google Earth]
+
* "Wizards" to create Projects, Graphs, Models, Scenarios, Sequencers, and Diseases
+
* Visual editors to edit Graphs, Models, Scenarios, Sequencers, and Diseases
+
  
* A complete data set that defines all of the countries specified by the [http://en.wikipedia.org/wiki/ISO_3166 ISO-3166 standard], this includes area land mass and recent human population data
+
Please see [[Join the STEM Community|How to Join the STEM Community]]
  
* A complete Lat/Long data set in [http://en.wikipedia.org/wiki/Geography_Markup_Language Geography Markup Language] (GML) format for all countries defined by the [http://en.wikipedia.org/wiki/ISO_3166 ISO-3166 standard]
+
You may also contact the [[The STEM Development Team| STEM developers]]  
  
* An extensive set of predefined "Graph" fragments that can be reused in user Models
+
New Contributors to STEM are always welcome. This includes not only researchers interested in disease modeling but also experts in GIS data or any other data that might be important in understanding or modeling the spread of infectious disease. We also welcome input from users and contributions to our documentation.
* An extensive set of predefined "Models", one for each country, that can be reused in user Models and Scenarios
+
* A set of predefined "Scenarios" that illustrate disease spread models around the Earth
+
* A predefined SEIR disease model for the [http://en.wikipedia.org/wiki/Spanish_flu Spanish Flu]
+
* Deterministic implementations of SI, SIR and SEIR disease models.
+
  
==What features are planned for future releases?==
+
To contribute to STEM, please use the standard Eclipse process. Open a "bug" in our bugzilla (https://bugs.eclipse.org/bugs/)
 +
A bug can be more than just a new defect - it can also be a new feature or other contribution.
 +
You can attach your contribution as a "patch" to your bug (http://wiki.eclipse.org/index.php/Bug_Reporting_FAQ)
 +
Please also feel free to e-mail the STEM development team, many of whom are Eclipse Committers [http://wiki.eclipse.org/index.php/STEM#The_STEM_Development_Team The STEM Development Team]. For those interested in joining the project, we also have a weekly phone call and a newsgroup, etc.
  
* [http://www.eclipse.org/birt/phoenix/ Business Intelligence and Reporting Tools] (BIRT) integration
+
== Where can I get more help ? ==
* History recording and playback
+
* Stochastic SI, SIR and SEIR disease models
+
* New experimental disease models
+
* Enhanced editor functionality (better Drag'n Drop)
+
* Enhanced visualizations including multiple views, hover, and many bug fixes
+
* Improvements in the interface (menu layout wizards, etc.)
+
* Improved documentation
+
* Improved build environment
+
* Lots of bug fixes.
+
  
==Can STEM be used for more than just disease modeling?==
+
Please start by reading the extensive documentation on our [http://wiki.eclipse.org/index.php/STEM wiki] and our [http://www.eclipse.org/stem/ website]. The STEM community also has a weekly conference call.  
 
+
The call is held most Thursdays at 12PM ET (9AM PDT).
Yes. The core components of STEM implement a graph based spatiotemporal simulation engine.  The components that extend it to disease modeling are in separate plug-ins and integrate themselves using Eclipse extension points.
+
For more information, or if you wish to join, please send mailto:judyvdouglas@verizon.net
 
+
==What is the most novel extension to STEM?==
+
 
+
The idea of creating a "pandemic game" out of STEM has been discussed by its developers for some time.  The basic idea would be to have "players" use their copies of STEM to connect to a central server with a single shared model. The players would make (or not make) decisions based upon their geographic assignment and these would be communicated to the server which would then update and propagate the changes to the model to the distributed player machines.
+
 
+
==Can STEM be used for "situational awareness"?==
+
 
+
Yes.  Basically, you can run a simulation in "real-time" with a Decorator that interfaces to the outside world.  That Decorator can access data from outside of the simulation (e.g., from a database or a web service) and then "inject" it into the canonical graph that holds the state of the simulation.
+
 
+
It should be possible to extend STEM to use an existing simulation to initialize other simulations so that users could monitor the world and then spawn off different identically initialized Scenarios that simulate different options given the current world state.
+

Latest revision as of 12:26, 8 October 2014

STEM TOP BAR.gif

Back

Where should I start?

To learn about how to use STEM, please read the Tutorials

The most important tutorial is probably the one that teaches about Creating a STEM Scenario

To learn about the design of STEM, please read the STEM Design Document

What platforms are supported?

STEM will run on any platform supported by Eclipse. Downloads are available for RCP versions of Windows, Linux, and Mac OSX. Java 1.6 and the latest is required. The STEM development environment requires the latest version of Eclipse. If a downloadable RCP version is not available for your platform, you must download the STEM source from Eclipse and run from the source.

What features are new?

Please see What's New in STEM

What are other features are available in STEM?

  • A full implementation of the STEM graph based simulation engine for spatiotemporal modeling
  • Geographic visualization of the spread of disease using internally implemented graphics
  • Geographic visualization of the spread of disease using Google Earth
  • "Wizards" to create Projects, Graphs, Models, Scenarios, Sequencers, and Diseases
  • Visual editors to edit Graphs, Models, Scenarios, Sequencers, and Diseases
  • A complete data set that defines all of the countries specified by the ISO-3166 standard includes area land mass and recent human population data
  • An extensive set of predefined "Graph" fragments that can be reused in user Models
  • An extensive set of predefined "Models", one for each country, that can be reused in user Models and Scenarios
  • A set of predefined "Scenarios" that illustrate disease spread models around the Earth
  • A wide variety of mathematical models of infectious disease
  • Lots more. We are adding features all the time

What features are planned for future releases?

For the latest release and plan information, please visit the STEM Project Plan Page

Can STEM be used for more than just disease modeling?

In principle, yes. The core components of STEM implement a graph based spatiotemporal simulation engine. The components that extend it to disease modeling are in separate plug-ins and integrate themselves using Eclipse extension points. Today we are focused on supporting a framework for modeling diseases. In order to model diseases one must also model populations, transportation, etc. So STEM is really a way to build models on top of other models. Some models, like models of insect vectors, may depend on global data including things like climate factors. All this "denominator" data is available as STEM plugins. Some users have build higher level economic models on top of disease models in STEM.

Where can I find some tutorials on STEM?

  1. Full length video In English
  2. Full length video In Hebrew
  3. Full length video In Japanese
  4. Full length video In Spanish
  5. 5 min Video (English)

Where can I learn about the design of STEM?

STEM Design Document

Are there publications where I can read more about STEM ?

Publications and Presentations on STEM

How can I contribute to STEM ?

Please see How to Join the STEM Community

You may also contact the STEM developers

New Contributors to STEM are always welcome. This includes not only researchers interested in disease modeling but also experts in GIS data or any other data that might be important in understanding or modeling the spread of infectious disease. We also welcome input from users and contributions to our documentation.

To contribute to STEM, please use the standard Eclipse process. Open a "bug" in our bugzilla (https://bugs.eclipse.org/bugs/) A bug can be more than just a new defect - it can also be a new feature or other contribution. You can attach your contribution as a "patch" to your bug (http://wiki.eclipse.org/index.php/Bug_Reporting_FAQ) Please also feel free to e-mail the STEM development team, many of whom are Eclipse Committers The STEM Development Team. For those interested in joining the project, we also have a weekly phone call and a newsgroup, etc.

Where can I get more help ?

Please start by reading the extensive documentation on our wiki and our website. The STEM community also has a weekly conference call. The call is held most Thursdays at 12PM ET (9AM PDT). For more information, or if you wish to join, please send mailto:judyvdouglas@verizon.net

Copyright © Eclipse Foundation, Inc. All Rights Reserved.