Results Viewer

From Syncrosim
Jump to: navigation, search
Results-viewer.JPG

The Results Viewer window allows you to view the results of one or more model SyncroSim simulations, including both charts and maps; it also allows you to export model results.


You can add scenarios to the Results Viewer from a right-click context-sensitive menu on the Scenario Manager (Add to Results). The top of the Results Viewer lists all of the results scenarios you have selected, while the bottom provides 3 options for how to view those results: Graphs, Maps and Export.


To add a result scenario to the Results Viewer:

  1. On the Scenario Manager, select the result scenarios for which you wish to view the results; you can select multiple items with Ctrl-Click.
  2. Right-click anywhere on the Scenario Manager window, and select the Add to Results option from the context-sensitive menu.
  3. The scenario(s) that you selected will appear in the bottom section of the Results Viewer dialog. Note that If you select the parent scenario and then select Results, all of the parent scenario’s associated results scenarios will be added.


To remove results from the Results Viewer:

  1. Right-click anywhere on the Scenario Name pane of the dialog to open the context-sensitive menu.
  2. Click on one of the available options to remove the checked run(s) from the Results Viewer

There must be at least one run listed in the Results Viewer before you can generate graphs, maps or reports.

Removing a results scenario from the Results Viewer does not remove it from the project – only for the list of scenarios available for viewing.


Charts Tab

Generate charts of your run results from the Charts tab of the Results Viewer. You can create line or bar charts of state class area and transition area for one or more scenarios.

A set of standard graphs is available with the sample data set from the View Results dialog; these are State Class, Transition Area, and Attributes graphs. These can be viewed without creating a new graph panel.


To define a new chart panel:

  1. With the Results Viewer open, and results scenarios you wish to compare listed in the Scenario Name pane of the dialog.
  2. Click on the New button at the top of the Graphs tab to create a new Graph Panel.
  3. Give the new graph panel a name by clicking on the default “New Graph Panel” name and typing over it.
  4. Click View. A Charts dialog will open that lists display options at left and has a right pane that is blank.
  5. From the list of options at left, open the Variables list, and select the variables you wish to graph, e.g., State Class Area (Acres).
  6. From the Include Data For list, select the strata to include from the Stratum list. You can choose individual strata or click in the (All) checkbox to select everything. If you have chosen to graph State Class Area, select data from the State Class list; if you have chosen to graph Transition Area, select data from the Transition Groups list.
  7. You can generate separate graphs for each state class or transition group you have selected by checking the appropriate option under Disaggregate By. For example, if you have chosen to graph Transition Area, you can generate separate graphs for each transition group you selected (under Include Data For) by checking Transition Group under Disaggregate By.
  8. At the bottom of the right-hand pane, specify the type of graph you wish to create by choosing either Line Graphs or Bar Graphs from the Create drop-down list. If you choose Bar Graphs, you will also need to enter the timesteps you wish to graph; enter timesteps as numbers separated by commas (e.g., 5,10,20). Separate graphs will be generated for each timestep you enter here.
  9. The number of graphs to be generated based on your choices will be displayed in the bottom left-hand corner of the dialog.
  10. Click on the Refresh button in the bottom left corner of the dialog to generate your graphs.
  11. Save your graph panel (File|Save, or click Save Project in the toolbar) so you can access it again in the future from the Results Viewer.

Chart-panel.JPG

Maps Tab

The maps tab allows you to display map outputs for spatially explicit runs.

To define a new map panel:

  1. With the Results Viewer open, and results scenarios you wish to compare listed in the Scenario Name pane of the dialog.
  2. Click on the New button at the top of the Maps tab to create a new Map Panel.
  3. Give the new map panel a name by clicking on the default “New Map” name and typing over it.
  4. Click View. A Maps dialog will open that lists display options at left and has a right pane that is blank.
  5. From the list of options at left, open the Variables list, and select the variables you wish to map, e.g., State Class.
  6. At the bottom of the right-hand pane, specify the timesteps you wish to map; enter timesteps as numbers separated by commas (e.g., 5,10,20). Separate maps will be generated for each timestep you enter here.
  7. The number of maps to be generated based on your choices will be displayed in the bottom left-hand corner of the dialog.
  8. Click on the Apply button in the bottom right corner of the dialog to generate your maps.
  9. Save your map panel (File|Save, or click Save Project in the toolbar) so you can access it again in the future from the Results Viewer.
  10. Note that the legend colors for state classes and transition types can be edited in the project definitions window.

Maps-panel.JPG

Export Tab

The export tab allows you to export map outputs for spatially explicit runs (as GeoTIFF rasters) and tabular reports for all runs (as excel or csv files).

ST-Sim can generate the following Maps and Excel reports:

  • Maps (only for spatially explicit runs)
    • State Classes: maps of state classes over time
    • Transitions: maps of transitions over time
    • Ages: Maps of the age of each cell over time
    • Time-Since-Transition: Maps of the time since transition for each cell over time
    • Strata: Maps of the stratum (Vegetation Type by default) of each cell over time
    • State Attributes: Maps of the state attribute value of each cell over time
    • Transition Attributes: Maps of the transition attribute value of each cell over time
    • Average Annual Transition Probability: Maps of the average annual transition probability of a cell over a specified time period
    • Stocks: Maps of stock amounts for each cell
    • Flows: Maps of flow amounts for each cell
  • Tabular Reports
    • State Classes: area in each state class over time
    • Transitions: area undergoing each transition over time
    • Transitions by State Class: area in each state class undergoing each transition over time
    • State Attributes: state attribute value totals over time
    • Transition Attributes: transition attribute value totals over time
    • Ecological Departure: Ecological departure by stratum over time
    • Stocks: Maps of stock amounts for each cell
    • Flows: Maps of flow amounts for each cell

To generate reports:

  1. From the Library Explorer, add the results scenarios for which you wish to generate a report to the Results Viewer.
  2. Switch to the Export tab.
  3. Double click on the report you would like to export or select Export... from the right click context menu.
  4. Tabular results for all of the scenarios selected will be exported to a single Excel spreadsheet (default) or csv file (choose Save As type: CSV File (*.csv)).
  5. Maps will be exported to GeoTIFF rasters in a directory of your choice.
  6. Repeat step 4 for additional reports.