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.
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. STEM also supports other viewers including GoogleEarth(TM) and GoogleMaps(TM).
The internal Map View should be 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
- Latitude and Longitude of cursor location
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
>window>preferences
This will bring up a dialog for user preferences. Expand the tags
>STEM>Visualization
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.