skip to main content
General RiverWare
DMI
Significant enhancements have been made to RiverWare’s Data Management Interface (DMI). New functionality includes the ability to import data in the middle of a timeseries and the ability to put multiple data files in the control file. Also, users can now invoke a group of DMIs all at once with the new DMI Group feature. With the enhanced DMI, users still create their individual executables and control files, however, this process has been made easier through a new graphical user interface. The graphical user interface makes the creation of user key words much more intuitive.
The user is encouraged to consult the DMI Documentation in the online help for a more detailed description of the functionality and use of the DMI.
SCT
The System Control Table (SCT) has been enhanced and re-implemented in the Qt graphical user interface (GUI). The new SCT Configuration dialog box adds ease to and extends the capabilities of configuring the SCT. For example, users can now reverse the axis orientation of the SCT so that run timesteps are viewed either vertically (in rows) or horizontally (in columns), depending on user preference. It is also now much easier to configure the time aggregation of slots. The user is encouraged to consult the SCT Documentation in the online help for a more detailed description of the SCT and other new functionality.
When loading an existing SCT, users are now prompted to either migrate and work with the SCT in the new QT GUI format (... 2.0) or continue with the old-style format (... 1.0). Users should note that the SCT is not backwards compatible-- once a SCT is saved in the 2.0 version, it cannot be opened again in the 1.0 version. Future RiverWare releases may not support the old SCT.
Computational Subbasin
A new subbasin type, the Computational Subbasin, has been added to RiverWare. The Computational Subbasin supports computations that involve more than one object, so-called “global” solutions, though they need not encompass the entire network. A Computational Subbasin is created through the same dialogs as other typed subbasins, but it, like simulation objects, contains slots and other attributes that you can inspect and change, by “opening” the subbasin. It contains no general slots; all slots are dependent on user-selectable methods. The Computational Subbasin is instrumental to the new flood control algorithms recently implemented in RiverWare. See the Flood Control section below for more details.
Optional Elimination of Comment Lines in Exported Slots
It is now possible for users to eliminate the comment lines that are automatically generated when exporting a slot. These comment lines start with a ‘#’ and include the slot name and the scale and units of the data. This caused problems for some users’ post-processing tools. To disable comment generation in Solaris, use the ‘setenv’ command to define the following environment variable:
setenv OLD_4P2_EXPORT_COMMENT_STYLE 1
Open Object Dialog
Slot Reordering
Whenever users re-order slots in the Open Object Dialog, this ordering is automatically saved when the model is saved. Now every time a model is loaded the Open Object Dialog will display the most recent slot ordering. Users can still toggle between the object’s “Custom” slot ordering, the “Saved Object-Type” slot ordering, and the “Default” RiverWare slot ordering by pressing a column header at the top of the list view.
Plotting
Plotting Keyboard Accelerator
A keyboard accelerator has been added to plot slots from the Open Object Dialog. Highlight the desired slot and then press:
Ctrl+P
Plotting Contour Curves
RiverWare now has the capability to plot three-dimensional table slots using contours. The default behavior plots column 1 of the table slot on the x-axis, column 2 on the y-axis, and the values in column 0 as the contours. Each of these contours is plotted as a distinct curve. In the Plot TableSlot dialog box, users can toggle the “Generate Contour Curves” button and select which column to plot on each axis.
Plotting TableSeries and AggSeries Slots
Users plotting TableSeries and AggSeries slots can now select which column to plot. (Previously, RiverWare always plotted the first column.)
Scaling
RiverWare now honors the user-set slot scaling value (e.g., 1000 cfs) when plotting. The scaling value is reflected on the plot axis labels.
DateAxis Toolbar
A new DateAxis toolbar is available under the Window menu of the plot dialog. This toolbar contains a date-time spinner which will automatically re-center the plot to the specified date. The toolbar also contains a “Synch the dates on all plots” button (a calendar, clock and down arrow) which will synch all the plots to the timestep of the currently selected plot. Synch dates can also be invoked with the keyboard accelerator Ctrl+D.
Hovering Over a Plot Point Displays Information
Hovering over a plot point will now generate a tool tip with information about that point: the slot name, time, and point value.
Accounting
Several fixes have been made for plotting accounting slots. Users can now select to plot Supplies directly from the plot dialog by selecting Data >> Add Series Curve, just as they would with any other type of slot. Supplies are now plotted in user units and slot names are correctly represented in the legend. It is also now possible to plot slots from the Account Detail dialog with “File >> Plot Slot”.
AggSeries Slots on the Data Object
Users can now add AggSeries Slots to Data Objects. Under the “Slot” heading in the Open Object dialog, select “Add AggSeries Slot”. The name of each column can also be edited.
Numeric Keypad
Many RiverWare Solaris users have reported problems using the numeric keypad (on the right side of the keyboard). The problem on Solaris is that the key mapping used for Solaris/X11 keyboards confuses RiverWare’s GUI toolkits (and those in other applications). The solution is to change the mapping of the numeric keypad keys to conform to a setup that RiverWare can understand. Instructions and a script file are available on our web site, under the RiverWare user pages:
• Log on as user: rwuser and password: Zanskar
Note:  This is NOT a problem on Windows. Windows users should ignore this.
Synchronizing With Run Control
Exclude Slots with Different Timestep from Run
When synchronizing objects with the Run Control, users now have the option to exclude slots that have a different timestep than that of the Run Control. This option may be useful, in particular, to retain data stored in Data Objects.
End of Run Diagnostic
RiverWare now displays a green diagnostic at the end of a run. The diagnostic will state whether the run finished, aborted, or was stopped. The diagnostic will also display the number of seconds elapsed since the run was started.
Periodic Slot
Change to Lookup Date on Periodic Slots with Irregular Intervals
If a lookup is done on the Periodic Slot for a date which falls exactly on an interval boundary, RiverWare returns the lookup for the prior interval. This was always true for Periodic Slots with regular intervals, the behavior has been added to consistently work for Periodic Slots with irregular intervals.
NOTE: This change could break existing rulesets. References to periodic slots at “date -1” might need to be replaced with the more natural “date”.
Horizontal Scrollbar
The Periodic Slot now has an “automatic” horizontal scroll bar that appears when the window isn’t wide enough to display all the columns. The minimum height of the slot is set to approximately three lines.
Inverse Interpolation
The inverse interpolation on periodic slots (given a date and a table value, return the appropriate column map value) has been re-implemented. The new behavior orders the interpolations consistently, thus fixing any inconsistencies in forward and backward interpolation.
NOTE: This change could potentially cause numeric differences in models with methods which use inverse interpolation on a periodic slot or in models with rulesets that call this function directly by calling getColumnValue.
Revised: 01/11/2023