OMS Console

The OMS Console has three primary user interfaces: (1) simulation, (2) parameter editor, and (3) analysis output.
The OMS Modeling Console is a graphical user interface (GUI) for the OMS development platform. It provides simple access to core features, such as simulation management, output analysis, and documentation generation. Using the Console is just one way to interact with OMS. As open source software, modeling communities can integrate OMS system components into their own IDEs or custom model development applications.

The main purpose of the OMS Console is to allow a modeler a straightforward and simple tool to develop a model, create a simulation, run the simulation, provide for parameter editing and offer ad-hoc post run analysis and visualization. The figures below provide an overview of the OMS Console.

The Console's principal UI is shown in the figure above. Several buttons and layout features are familiar standard elements. The UI is organized as follows:

Working Directory

Simulation Tabs

Toolbars

Editor

Console Output

Status Line

1. Create a new, empty simulation.
2. Open an existing simulation from <working directory>/simulations.
3. Save all open simulations.
4. Select options and settings (show hidden files, folders; clear output before next run)
5. Create a new project (currently inactive)
6. Close current project
7. Open project
8. Save simulation script to a file. If the file is new, it will prompt for a name.
9. Run the simulation script.
10. Interrupt and stop a running simulation. If no simulation is running this button is disabled.
11. Open the Parameter Editor loading referenced parameter files from the current simulation. The Parameter Editor is explained in a section below.
12. Open the Analysis Output window. The window will open if a simulation specifying analysis has run. The analysis window is explained in more detail below.
13. Generate Docbook5 documentation of the simulation and store it into the project output folder.
14. Clean and build the model. This is an alternative to doing this in Netbeans or the IDE being used.
15. Open the last output folder using the computer operating system file explorer.
16. Clear the console output for this simulation.
17. Set logging level for the simulation. This will result in more or less verbose output during simulation execution.
    
18. (Not shown) Create a SHA digital signature of the simulation and print the simulation fingerprint to the Analysis Output Window.
    

OMS Console - Parameter Editor

The editor works on parameter files that adhere to the OMS CSV parameter file format. Such files can be easily edited with other external tools such as Excel, however the parameter editor provides an easy to use interface to manipulate parameter values numerically.

Note that only parameter files referenced as properties in the model parameter sub-element in a simulation using the .. parameter(file:'<name>') ... construct can be loaded into the Parameter Editor. Parameters and parameter files referenced as sub-elements of the parameter sub-element, that is, contained within curly brackets "{...}" cannot be loaded into the Parameter Editor.

The figure above shows the Parameter Editor with loaded parameters. The layout of the window is organized as follows.

Parameter File

Filter

Command Console

Parameter Editor Panel

The figure above shows the parameter editor with an applied dimension filter. The table presents all parameters bound to a specific dimension. Selecting cells in the table will print basic statistics about those on the bottom of the window. Any area can be selected, a column selection will print statistics about the whole column at the bottom of the editor.

OMS Console - Analysis Output

The tile bar shows the output folder containing the analysis data. Depending on the setting in <outputstrategy>, such output can be versioned or unversioned. With either setting, the last output folder of a simulation run is presented.

The analysis tabs contain the plots, graphs, and charts, such as timeseries, error, scatter, flowduration, and other analyses. The tab name reflects the analysis performed.

A part of the analysis section used to create the plots above is shown below.

...
analysis(title:"Simulation Output") {
    timeseries(title:"East Fork Carson", view: COMBINED) {
        x(file:"%last/out1.csv", column:"date")
        y(file:"%last/out1.csv", column:"basin_cfs")
        calc(eq:"simulated - observed") {
             simulated(file:"%last/out1.csv", column:"basin_cfs")
             observed(file:"%last/out1.csv", column:"runoff[0]")
        }
        y(file:"%last/out1.csv", column:"runoff[0]")
    }
     timeseries(title:"Error", view: MULTI ) {
...

Note the timeseries sub-element of analysis maps to the view of the plot graph above. Note the variable %last references the last output folder of a simulation run. The plot contains three y axes, one of which involves the calculation of simulated minus observed values.

To reiterate, the Analysis Output window displays graphics only if the analysis DSL element is specified in the simulation file.