|Note: You can rename, delete and view data in Results Manager, but it cannot be edited.|
In Results Manager there are a number of key terms. These are mostly related to naming conventions for results, groups of results, and how those results are manipulated. See Table 1 below.
|Scenario run||A run of a scenario in Source. 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 (eg. Total Inflow Volume, Figure 1) or a column in a loaded time series file.|
|Result set||A logical grouping of results. This is commonly used to discuss results from a scenario run, but could also be applied to, for example, downstream flow from multiple runs. If you load a result file, it contains a result set.|
|Result file||A *.res.csv file. This is a Source-generated text-based csv file that also contains metadata, which allows you to import the file back in to Source and maintain data structure and units.|
|Result tab||Displays result(s) in the central workspace of Results Manager, this is usually a single time series result or a custom chart, but can also be a unique view specific to a non-time series result or user-generated statistics (Figure 1). See Result Tabs.|
|View tab||Displays a view of the selected result or custom chart, such as Chart, Table or Statistics. See Result tabs.|
|Time series||Data that has been measured at a regular time interval (eg. observed daily flow). There are several time series file types compatible with Source (refer to a complete list in Data file formats). One of the most commonly used time series file types is *.csv.|
|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. See Custom Charts.|
|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. See Transforms.|
The configuration of Results Manager includes all custom charts, transforms, user-generated statistics and file locations of loaded time series and results files. You can save your current configuration as a Results Manager configuration file (*.dora), allowing you to load that configuration in the future. See Configurations.
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 Scenario run Metadata). The metadata can be saved by supported file types.
The Results Manager toolbar (Figure 3) is located near the top of the Results Manager window and includes load, save, search and transform options.
You can load a:
You can also save the current configuration (Ctrl+S) and set up your data transforms (Ctrl+Shift+T). To go to a result in the tree menu, select the search icon and then start typing a search string for results from the tree menu for the currently active scenario to appear as you type, see Searching for results.
The central workspace in the Results Manager window is where you will see your charts, tables, statistics and other results. For some displays, there are right click contextual menus within the central workspace. The display in the central workspace is specific to the item you have selected in the tree menu or custom chart and statistics pane - if no item has been selected, no chart will be visible.
The tree menu on the left side of the Results Manager window (Figure 4) shows all result sets from the current session, any saved results from previous runs, along with any loaded result files (*.res.csv) and time series files (Data file formats).
Once run, results from a scenario appear grouped together under Latest run and as a separate item grouped by scenario in run order. Those previous runs are named using the following convention, where # represents the run number from the current session:
The Results Manager tree menu is shown in Figure 2.
|Note: Once a scenario run is complete, clicking on a node in the schematic or geographic editor will highlight that node's results in the Results Manager tree menu for the currently active scenario result set. If no scenario result set is active (eg. because a custom chart is selected), the Latest Run result set is used.|
The following should also be noted.
The central workspace of Results Manager contains result tabs, which can display:
To use result tabs:
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.
|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.
You can search for specific results without navigating through the tree. Searches can be undertaken in one of two ways:
Each of these methods searches the results differently:
A Results Manager configuration file (*.dora) contains a record of:
Note: Saving your Source project file will save the same information, but will also save any run results that you have selected using Save Run In Project.
Choose Help » HotKeys to view a list of shortcuts that can be used within the Results Manager (Figure 7).
Results Manager can be run independently of Source, allowing you to analyse previously saved Source results or time series from other programs without opening Source. You can launch Results Manger in stand-alone mode from your Windows Start menu, the standard location is:
Start » All Apps » eWater Source 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). This opens a Configuration dialog (Figure 8) that allows you to configure the following options: