DSL Element - analysis{}

• Time series plots
• Flow duration plots
• Scatter plots

An analysis can contain any number of those plots as sub-elements as shown below:

sim(name:"Efcarson") {
   ...
   analysis(title:"Simulation Output") {
      timeseries(title:"East Fork Carson") {
         x(file:"%last/out1.csv", column:"date")
         y(file:"%last/out1.csv", column:"basin_cfs")
         y(file:"%last/out1.csv", column:"runoff[0]")
      }
      timeseries(title:"Error") {
         x(file:"%last/out1.csv", column:"date")
         calc(eq:"simulated - observed") {
            simulated(file:"%last/out1.csv", column:"basin_cfs")
            observed(file:"%last/out1.csv", column:"runoff[0]")
         }
         calc(eq:"simulated - observed", acc:true) {
            simulated(file:"%last/out1.csv", column:"basin_cfs")
            observed(file:"%last/out1.csv", column:"runoff[0]")
         }
      }
      flowduration {
         y(file:"%last/out1.csv", column:"basin_cfs")
         y(file:"%last/out1.csv", column:"runoff[0]")
       }
      scatter {
         x(file:"%last/out1.csv", column:"basin_cfs")
         y(file:"%last/out1.csv", column:"runoff[0]")
       }
   }
   ...
}

The configuration as shown above will result in output graphs as shown below. The whole analysis will appear as a separate window, each plot will have its own tab and graph. The figures below actually show the same window with different tab being activated.

Example Analysis

General Rules for Referencing Data Sets

x(file:"c:/tmp/SIM/0003/out1.csv", table"efc", column:"runoff")

For the example above, a column is referenced fully by its file, table, and column name. The file name is absolute.

x(file:"c:/tmp/SIM/%last/out1.csv", table"efc", column:"runoff")

A column is referenced fully by its file, table, and column name. The file name is absolute but references the last simulation run. The meaning of 'last' depends on the chosen output strategy.

x(file:"%last/out1.csv", table"efc", column:"runoff")

Now the file reference is in context to the simulation. It points to a file in the last output folder for this simulation.

x(file:"%last/out1.csv", column:"runoff")

If the table name is not provided, the name of the simulation is assumed. The last variant is preferred, since it provides the most flexibility for referencing data path independent.

OMS defines three 'variables' to refer to s simulation run context. They can be used in a file value as shown above. Note that for a SIMPLE output strategy, they all refer to the same output folder.

Element analysis{}

Specification

Sub-elements	Description	Type	Default	Occurrences
timeseries{}	Time series chart			Zero to many
scatter{}	Scatter plot			Zero to many
flowduration{}	Flow duration chart			Zero to many

Parent(s)
model{}