The Results Manager allows you to examine and analyse scenario results in MUSIC X. Results can be evaluated graphically in charts, numerically in tables or as statistics, and they can also be filtered and manipulated using transforms. With custom With custom charts, you can also view and statistically analyse multiple results within and between runs, compare results to external data sources and automatically update with the latest results each time a model is run.
...
Term | Meaning |
|---|---|
| Scenario run | A run of a scenario in MUSIC X. A scenario run may also be referred to as a 'run' and the most recent is referred to at 'Latest run' in the tree menu in Results Manager. |
| Result | A single recorded output from a scenario run. |
| Result set | A logical grouping of results. This is commonly used to discuss results from a scenario run. |
| Result file | A *.res.csv file. |
| Result tab | Displays result(s) in the central workspace of Results Manager. |
| View tab | Displays a view of the selected result or custom chart, such as Chart, Table or Statistics. |
| Time series | Data that has been measured at a regular time interval (eg. observed daily flow). |
| Custom chart | A custom chart is a user-created collection of two or more time series results that allows comparison between those results graphically in charts, numerically in tables or by comparative statistics. |
| Transforms | Transforms allow you to modify (or transform) the view of the data. Once generated, they can be used as a template for another action, such as applying to custom charts. |
| Configuration | The configuration of Results Manager includes all custom charts, transforms, user-generated statistics and file locations of loaded time series and results files. |
...
Each scenario run is issued a unique ID. When export results from a scenario run, the exported .res.csv files also includes this ID. The metadata associated with this run ID is available in results manager (See Figure 2 below). The metadata can be saved by supported file types.
Toolbar
The Results Manager toolbar (Figure below) is located near the top of the Results Manager window and includes load, save, search and transform options.
...
The custom charts and statistics pane is located to the left of the central workspace, below the tree menu panel. It lists the custom charts and user-generated statistics that have been created in the Source project. The pane and its contextual menus are shown in Figure 6. The icon beside an item in the pane indicates that a transform has been applied. Note that Add Transform is only shown if there are available transforms.
...
.
...
Managing Results
Note: For simplicity, any loaded time series (*.res.csv or other formats) are called results.
...
Time series data can be imported from, and exported to, a variety of file formats, as discussed in Data Import and Export. Please refer to Data file formats from Source User Guide.
Searching for results
You can search for specific results without navigating through the tree. Searches can be undertaken in one of two ways:
...
- The Search field searches all levels of the tree menu (including loaded results or time series) for the entered phrase and hides any result that does not contain that phrase anywhere in its path. For example searching for 'Inflow' will leave unhidden all results with the word Inflow in their path, which includes all results with inflow in their name (eg. Total Inflow Volume), and also all results for all Inflow nodes. Therefore, this search field is most useful when searching for a specific result (eg. Downstream Flow VolumeNode Water Balance) or node name (eg. Fish Creek Confluencewetland).
- The Go To option allows you to search the currently active scenario using the wild card * to represent any character. If there is no active scenario (eg. because you have selected a custom chart), it will search in the Latest Run. For example, "Conf*Inf" can be used to find the Total Inflow Volume for all Confluence nodes, regardless of their node names. You can then select one of the returned results and it will be displayed. This dialog displays a maximum of 16 results, even if there are more results that meet the search criteria.
Results Manager Configurations
A Results Manager configuration file (*.dora) contains a record of:
- All custom charts;
- Transforms and where they are used;
- User-generated statistics;
- File locations of loaded time series and results files;
- Water Year start date (set in Project Options);
- Short table headers (set on Table view tab); and
- Visible decimal places (set in Application settings).
You can:
- Save the current configuration of the Results Manager by selecting Save Configuration from the File menu or toolbar; and
- Load a previously saved configuration using the Load Configuration from the File menu or toolbar. The integrity of a configuration file depends on the run order being consistent.
...
Hot Keys
Choose Help » HotKeys to view a list of shortcuts that can be used within the Results Manager (Figure 7below).
Figure 7. Results Manager, hotkeys
Stand-alone mode
Results Manager can be run independently of SourceMUSICX, allowing you to analyse previously saved Source MUSICX results or time series from other programs without opening SourceMUSICX. You can launch Results Manger in stand-alone mode from your Windows Start menu, the standard location is:
Start » All Apps » eWater Source eWater MUSICX n.n.n.n » Results Manager n.n.n.n
The only difference between stand-alone mode and running Results Manager within Source is a Configuration Options button in the Results Manager toolbar (Figure 8)as shown on the Figure below. This opens a Configuration dialog (Figure 8) that allows you to configure the following options:
- Enable Rounding – Determines whether the values in the Table and Statistics views are rounded to the number of places entered in Visible Decimal Places.
- Short Table Headers – Toggles on or off the display of long or short names of results in the Table view. Can also be enabled on the Table view tab.
- Water Year Start – Allows you to set the default water year start date, which affects the calculation of statistics in the Statistics view.
Figure 8. Results Manager toolbar, stand-alone mode
