Skip to main content
Jump to: navigation, search

STEM Map View



STEM Map View

The STEM Map View is a light weight build in viewer that allows a user to watch a simulation at run time. Just start a new simulation with the STEM application by selecting any scenario, right-click and select run. STEM will automatically switch to the Run-time perspective and you should see the map view by default. STEM also supports other viewers including GoogleEarth(TM) and GoogleMaps(TM).

The internal Map View should is visible by default in the run time perspective. When a valid simulation is started, after the data is loaded into memory the map should display the polygons corresponding to the administrative divisions in the region being modeled.

  • To move or recenter the map, simply click, hold, and drag to the region of interest.
  • To zoom in or out, use the up and down arrow keys


Right clicking anywhere on the map brings up a dialog that allows a user to:

  • Change the gain factor or "brightness" of the display
  • Toggle between logarithmic or linear mapping between (e.g.) the fraction of infectious people and color intensity
  • Turn polygon borders on/off


During a running simulation if you hover the cursor over the map an informational dialog will appear with:

  • The name and ID of the location the cursor is over
  • The area
  • Information on populations present
  • SEIR indicators and the current percent value
  • Latitude and Longitude of cursor location
  • Timestamp value


On the lower left hand side of the map view (see above) is a combo box that allows a viewer to select different types of edges to display. By default, no edges are displayed. If the graph in a running simulation contains edges such as common borders or roads, you can select them with this combo box and see them on the map. In the example above, common borders between physically adjacent regions are shown. Do you see the places where neighboring regions are separated by a river? These have no connecting edge. Users can add new edge collections to STEM (for example bridges) and add them to a graph. In the future we will also provide an interactive graphical editor.

STEM also provides the ability for users to customize colors used in the system. To use this feature, when the simulation is running simply go to the top menu-bar and click



This will bring up a dialog for user preferences. Expand the tags


The Visualization tag itself allows a user to assign a particular color to particular types of data (for example, 'I' => RED). The Map Colors tab allow customization of Map Foreground and Background colors, polygon border colors, edge Colors, etc.


Hide options bar

In order to increase the map area, the lower options bar can be hidden by toggling "Shop Options" in the context menu

Hide option bar1.png Hide option bar2.png

View preferences

The number of open map views, map position and zoom, view adaptions in the context menu as well as in the the options bar are automatically stored as preferences as a function of the running simulation. If this simulation is run another time, the preferences will be restored. If a view is no longer needed, it must be closed while the simulation is running/paused. Consequently the view will be removed from the preferences and no longer opens up when the simulation is started again.

Close view preferences.png

Back to the top