Following are special attention notes, indicating that:

If you have any questions, contact RiverWare-support@colorado.edu.

Modifications were made to many category and method names on objects and accounts in order to adhere to a standard naming format. See the appendix, “Appendix - Category and Method Name Changes”, for a complete list of the changes. Expect many warning messages notifying you of the name changes the first time a model is loaded in RiverWare 6.5. There should be no change in model behavior or results.

If you use the Heron Inflow calculation Reservoir Account Slot Inflow method, see “Heron Inflow calculation” for model changes and updates.

The unit type was changed for the K Factor slot in the Pan and Ice Evap reservoir method from LengthPerTemperature_F to VelocityPerTemperature_F. These are automatically updated on model load and the scheme is set to display previously shown units. RPL expressions that reference this slot must be updated or unit type inconsistencies will occur.

Previously configured background colors are no longer used, you must reset them.The color will be saved in the model file instead of a user setting. See “Background Colors Saved with Model File” for more information.

The dispatch conditions when solving given Diversion for these two objects was modified. Under certain situations, you could have additional results, but existing results should not be modified. Also, the error checks are less restrictive, so a run might succeed when it previously failed. See “Dispatch methods” for more information on the Water User.

The Methods tab on the Open Account dialog now supports display of method categories in a default order. In this order, dependent categories/methods appear below the superior categories. A new Order menu appears below the list.

The following improvements were made to the Water Rights allocation solver for performance improvements:

In the test model (22 year daily planning model), the total run time was reduced by 45%.

You can now allow negative flows in the water rights solver. This includes a new category, Negative Flow Appropriation and method, Allow Negative Flows, on the passthrough account on reaches, reservoirs and control points. When this method is selected, a new slot Temp Available Before Appropriation is added. It tracks the available water before each right is visited. If there are negative flows, upstream allocations cannot make a downstream senior more negative, but doesn't try to fix the negatives. See “Negative Flow Appropriation” for more information.

In batch mode, the command line keyword console was added to the --log argument. Using --log console shows a console window when RiverWare sends text to 'standard out' or 'standard error' when no log file is specified. Either --log console or --log <file> (OR no --log argument) can be used.

In batch mode, the following RCL command was added: RequireVersion <major>.<minor>[.patch]This command tests the version of RiverWare. It fails with an error if the current version is less than the specified version. See “RequireVersion” in Automation Tools for more information.

The HDB Server has been eliminated and Oracle connect code for HDB is now incorporated into RiverWare. The communications with HDB are faster and more robust. As a result, some configuration settings for HDB datasets are no longer relevant and have been removed. More information on the HDB interface can be found “HDB Datasets” in Data Management Interface (DMI).

Control File-Executable DMIs can now be limited to only write output data for the run range (Start Timestep to Finish Timestep). Check the Limit Output to Run Range toggle on the DMI Editor.

A Show Filter Statistics option was added to the Settings menu. When enabled, a single-line filter statistics panel appears below the message list. This indicates the total number of diagnostics messages and how many are shown and hidden due to message filtering.

The Diagnostics Output Window now supports the following three right-click context menu operations:

The Diagnostic Output Window's Message Popup Dialog previously supported an Open Selected Named Item... button which opened up the dialog for that object, account or slot. This capability was extended to support RPL Objects (Sets, Groups, Blocks, User-defined Functions).

For more information, see “Diagnostic Output Window” in Debugging and Analysis.

Performance has been improved when running with the diagnostics output window open. Also, during filtering operations that are expected to take more than four seconds, a progress bar and abort button are shown.

In the diagnostics output, long diagnostic messages are shown as a wrapped tooltip when mousing over individual messages.

Diagnostics were added in the Dispatch Management Controller category. After a method executes (and does not abort) one of the following two messages is posted, as appropriate:

This enables you to better diagnose when a dispatch method completes.

When a Distributed Multiple Run is executed from batch mode, the MRM controller no longer shows a user interface. If you still wish to show the user interface, use the --showui argument.

The distributed MRM working directory and configuration file now allow the use of environment variables.

In the MRM Configuration dialog, on the Iterative Runs tab, the label Priority was changed to Index. Iterative MRM rules are not strictly prioritized like Rulebased Simulation Rules, but they are indexed for organization. See “Index vs Priority” to below

The capability to use ensembles as input and output was added to Multiple Run Management. A check box for using input ensembles now appears on the Input tab of the MRM Configuration dialog, which will add a new Ensembles tab to the dialog. You select input and output ensembles for use with the multiple run, and can choose particular traces for the input ensembles. The number of traces in input ensembles determine the number of runs in the multiple run.

You can now export an object using the File Export Object... menu from the Open Object dialog.

When solving given Diversion, (processSequential_givenDiversion and processLumped_givenDiversion) Incoming Available Water was removed from the required knowns in the dispatch conditions.This isn't necessary to solve. Also, Total Depletion, Total Diversion, and Total Unused Water were added to the potential governing slots.

See “Process Sequential given Diversion” in Objects and Methods for more information.

A new Inline Turbine Release and Bypass category was added to the Inline Power Plant. The default Specify Flows method uses the previous approach to compute the Bypass and Turbine Release. The new Flow Tables approach uses two new tables Flow vs Min Bypass and Flow vs Turbine Release. This method performs lookups to get the appropriate flow values. See “Flow Tables” in Objects and Methods for more information.

On the Flow vs Power Table, the zeroth column label has been changed from Turbine Release (or very old Inflow) to Flow to make it generic. Old models will be updated automatically. Any RPL expression that reference this column by name will need to be modified. See “Flow vs Power Table” in Objects and Methods for more information.

The following slots were added to the Peak Power Equation with Off Peak Spill power method.

See “Peak Power Equation with Off Peak Spill” in Objects and Methods for more information.

The following slots were added to the Plant Power Equation power method.

See “Level Power Reservoir” in Objects and Methods for more information.

In addition, the Input Energy Adjustment category and Reduce Input Energy method are now available when the Plant Power Equation Release method is selected. If Energy is input and the resulting Turbine Release is greater than the maximum turbine release, the Max flag is set on Energy and the reservoir will recompute the maximum energy possible.

See “Level Power Reservoir” in Objects and Methods for more information on the Reduce Input Energy method.

Previously the default method in the Routing category was No Method, which was actually an invalid method and would produce an error. Now the default method is No Routing, “No Routing” in Objects and Methods

On the Reach Routing category, there are now two versions of the Kinematic method:

A new method Allow Excess Specified Outflow was added to the Input Outflow Adjustment category on the Reservoirs. This method allows you to specify (I or Z) an Outflow that is larger than the computed (Turbine) Release plus Spill. When this happens, the extra outflow is set on the new Outflow Exceeding Max series slot.

See “Level Power Reservoir” in Objects and Methods for more information.

In the calculation of Anticipated Storage as part of the Cumulative Storage Value Table calculation in Simulation or Rulebased Simulation, if an intransit flow value (inflow on an upstream lagged reach) was missing, it could previously cause the run to abort with an error message. A missing intransit flow value could also result in the calculation of Anticipated Storage using Storage only without accounting for intransit water. Now a missing intransit flow value will result in Anticipated Storage remaining unsolved (NaN), and an informational diagnostic message will be posted in the User Methods diagnostic category. The run will no longer abort.

See “Cumulative Storage Value Table” in Objects and Methods for more information.

The following changes were made to the Heron Inflow calculation Reservoir Account Slot Inflow method “Heron Inflow” in Accounting

The unit type was changed for the K Factor slot in the Pan and Ice Evap reservoir method from LengthPerTemperature_F to VelocityPerTemperature_F. These are automatically updated on model load and the scheme is set to display previously shown units. RPL expressions that reference this slot must be updated or unit type inconsistencies will occur.

In the solveSequential_givenDiversion and solveStandAlone_givenDiversion, Incoming Available Water was removed from the required knowns. This isn't necessary to solve. Also, Depletion and Outgoing Available Water were added to the potential governing slots.

For these two dispatch methods, the error checks if Diversion > Incoming Available Water and if Diversion > Diversion Requested were removed. These two checks made these dispatch methods unnecessarily restrictive.

This could affect existing models as it no longer errors in the above cases. Under certain situations, you could have additional results, but existing results should not be modified.

See “Solve given Diversion” in Objects and Methods for more information.

On the Water User, a new method was added to the Diversion and Depletion Request category called Specify Scheduled Requests. This method allows you to specify an initial scheduled amount (as either a series or periodic relationship) and then reduce the schedule to the requests. For more information, see “Specify Scheduled Requests” in Objects and Methods.

The Optimization section of the RiverWare Help was enhanced. See “Optimization Overview” in Optimizationto access the help. Information was added to the following sections:

The table data verification has been improved for optimization tables. Certain tables are checked for increasing values. Sometimes, these tables meet the more stringent requirements of optimization when a reservoir is within a “normal” operating region, but violate these conditions on the extreme parts of the curve, such as for a Probable Maximum Flood (PMF) when optimization would not be used. This enhancement allows you to limit optimization data checking to the normal region. If you have specified a minimum limit for data checking, data checking is skipped until the table exceeds the minimum value. If you have specified a maximum limit for data checking, the data checking ends once that limit is reached. For 3-dimensional tables, this logic may be applied both to the range of z values and to x or y within a block of constant z values. The following linearization and other tables used in optimization are now checked for this limited range.

More information is available “Create an Optimization Goal Set” in Optimization.

For Table Slots that are verified, you can configure the Min/Max from the Slot Configuration dialog “Optimization Limits for Data Verification” in User Interface or the Configure Existing Slots dialog “Global Slot Configuration Options” in User Interface. To locate the slots, use the selector’s new Supports Opt Limits filter “Selecting Slots” in User Interface.

You can also use Control File-Executable based DMIs to bring in the Min/Max from data files. Use the scale, unit, opt_min, opt_max data file keywords, “Data Files” in Data Management Interface (DMI).

In a typical policy, most problem solutions are immediately followed by the freezing of solution limiting variables and constraints. This freezing occurs automatically but only for solutions that occurs during execution of a Repeated Maximin statement; for freezing to occur after solutions caused by statements of other types, the policy must contain an explicit Freeze statement. When a problem solution is not immediately followed by a freeze before the next solution, it is sometimes useful to know which constraints and variables would have been frozen had a Freeze statement been executed. The solution analysis tool has been enhanced to report this information. When more than two solutions occur before a freeze, a single variable or constraint might have been frozen at multiple solutions, but is reported for only the earliest solution. For more information on the Priority-Oriented Optimization Solution Analysis Tool, see “Priority-oriented Optimization Solution Analysis Tool” in Optimization.

Model Reports “Model Report” in Output Utilities and Data Visualization allow you to generate a customized HTML document describing various aspects of a model including the configuration, RPL policy, slots, and plots. In the Model Report, the following new Item Types have been added:

See “Selected Item Settings Area” in Output Utilities and Data Visualization for information on the Item Types.

Plotting of periodic slots is described in “Parametric Curves” in Output Utilities and Data Visualization.

The following improvements were made to the Pie Chart output device “Chart” in Output Utilities and Data Visualization:

Plot Pages now have configurations options for the headers and footers that are shown when printed. Use the File  Print  Printed Header/Footer Configuration... For more information, see “Printing and Exporting Plots” in Output Utilities and Data Visualization.

When regenerating a plot from the Output Manager, duplicate plots are no longer created. The existing plot is updated.

The Scale to Specified Time Range button is shown to the right. Clicking the button opens the dialog below. Now there is the option to Apply to All Open Plots. This sets the visible range of all open plots to the specified range. Each plot would need to be saved to preserve that range.

For WITH statements, the variable name is shown in the rule execution diagnostics.

The term index is now used to indicate the order of RPL rules/methods when the order of the rule/method in the set does not determine the priority or when there is no priority associated with the rule. The index is displayed in a new Index column of the RPL set editor for the following RPL sets:

The RPL set editor no longer displays the priority column for sets to which the concept of priority does not apply:

The approach used by Initialization rules was modified to show which rule set a particular slot value. The Initialization Rules set editor now shows an Index, Flag and Priority column display.

You can now see a tool tip on any slot value display showing the Rule or Initialization Rule that set that value. See “Series Slot Value Information” for more information.

Canceling editing of an empty expression is easier to cancel. You can now cancel these edits by pressing Esc, Enter or clicking away from the in-line editor menu.

When a slot lookup expression is selected, Slot[ ], Slot [E,E], or Slot [E], the slot expression is automatically selected, so you can immediately select the slot without an additional click.

The RPL Palette Slot Selector now preserves your filter settings and prior selections.

The wrapping from the comment editor dialog is now retained and shown in the RPL editors. That is, when you hit enter in the comment editor OR the line wraps, the comment in the RPL editor will appear the same. See “Comments” in RiverWare Policy Language (RPL) for more information.

The display of OBJECTS in RPL was improved not to show the % symbol or quotation marks.

The following functions were added. They return a list containing all of the column or row labels of the input slot, respectively.

The following functions now support Agg Series slots:

A new function, Get3DTableVals was added. The function returns the values from a 3D table in a list. For more information, see “Get3DTableVals” in RiverWare Policy Language (RPL).

The HasRuleFiredSuccessfully was enhanced to behave as follows:

See “HasRuleFiredSuccessfully” in RiverWare Policy Language (RPL) for more information.

RPL set and group editors have a new Add To Report Group... operation. A RPL object selector is presented for you to identify the destination Report Group.

When dragging at item to the first item within the list, the confirmation dialog now provides an additional option to place the dragged item in the first position.

A name filter was added to the RPL Object Selector dialog. This dialog is used when selecting rules/goals from diagnostics and when selecting RPL objects in a model report.

Index and Flag columns were added to the RPL set analysis tool under the Window Columns menu

You can now change the color of the text shown for RPL Objects (Rule, Group, Function, etc) in a RPL set. Rules and functions inherit their color from the group unless they are explicitly changed.

The Resume Run capability has been removed from the user interface. Note, it is still possible to Pause and Continue a run. But it is no longer possible to Resume a run after the run aborted or after clicking the Stop button.

Scripts are an exciting new feature that allow you to automate many of the tasks involved in operating your model. Scripts are organized sequences of actions that you configure and execute.

Create a script to update your operations model to a new water year. Use a script to convert an accounting model to a planning model. Run a script to prepare your model for a run by setting the time range, importing values, and even executing the run. The opportunities are endless.

Scripts are created by a model developer in the Script Manager and the Script Editor. They are executed by a model user through the Script Dashboard which provides an interface where the user can set values through sliders, buttons and editors. Actions can even be hidden from the dashboard so only the desired pieces of information are shown.

In the initial implementation, there are over twenty action types you can add to your scripts. This framework is extensible so additional actions can be added in the future.

For more information on Scripts, see “Script Management” in Automation Tools.

The SCT has supported optional time dividers between the common time intervals. Now 6-hour time dividers are supported within hourly models. They use the same user-configurable color as 4-hour dividers. Note, 4-hour or 6-hour dividers can be shown, but not both.

The SCT's aggregated, horizontal timestep view now supports an alignment option for detail row header text. That row header text used to be just right aligned; now it can be left aligned.

When closing the SCT, the confirmation dialog is no longer shown if the SCT is locked and hasn't been unlocked during that session.

The Flag buttons were improved so it is clear when they are enabled and disabled.

The SCT now shows 'P', 'm' and 'A' series flag letters for accounting outputs.

When in Horizontal Timestep Axis Orientation, the navigation was modified so that when you hit Enter, it goes to the next cell in the series. This is not necessarily the cell immediately below.

Similarly, when you import paste a column (or row) of data, there is now an option to Paste clipboard column into Series Slot. When this option is selected, the pasted data will go only into the specified series regardless of the aggregation. Uncheck the box to paste across multiple cells instead of within a single series.

Tool tips now provide additional information about how individual values were set. In particular, when you hover the mouse over a value for which the relevant information is available, tool tips display which rule, DMI, or other method set the value. For rules, right-click and choose to Open Rule N from the menu. See “Series Slot Value Information” for more information.

The SCT was enhanced to show slot descriptions from the SCT:

If all existing series slots within the SCT have the same timestep size, the following adjustments are automatically made to the SCT configuration's Timestep Size Override.

The following enhancements were made to the slot selector filters:

The selector panels now allow you to right-click and choose to Copy Selected <Items>. This copies the list of selected items to the clipboard. Also, on the most specific panel, you can Trim Selection. It deselects items in the superior parts of the selection which don't contribute to the final selection.

It is now possible to insert a column in an agg series slot including before the first column.

For dialogs that display Series Slot values, like the Open Slot, Open Account and SCT dialogs, tool tips now provide additional information about individual values. In particular, when you hover over a value for which the relevant information is available, one of the following tool tips is displayed:

For the last three two rule items, right-click and choose to “Open Rule N” from the menu. See “Tooltips” in User Interface for more information.

A right-click context menu was added to the Table Slot Row/Column Label Editor Dialog. It is used for editing either Row or Column labels for a particular Table Slot. The dialog presents a single column of editable cells, one cell per Table Slot row or column. You can use the new menu to copy, paste, or clear the labels.

Timestep navigation was improved by re-implementing the datetime controls in many dialogs including series slots, plots, and the run control. The controls now include left and right arrows (instead of up and down arrows) and a new global icon used to global scroll to the selected timestep. The screenshot shows the controls available on the plot In addition, every datetime control has a right-click context menu allowing you to Global Time Scroll, Select All, and Copy/Paste the datetime.

The following units were added:

The Reach's Simple Well-Mixed Salinity methods were enhanced for better handling of salt mass for flows near zero. Also, the methods allow Diversion Salt Mass to be greater than Inflow Salt Mass to accommodate modeling techniques employed by some users.

Improved Simple Well-Mixed Reach Salinity Modeling when solving upstream. Previously, the Return Flow Salt Mass could only be linked to the same object to which the Diversion Salt Concentration was linked or an error would occur. Now, this is allowed, but the Return Flow Salt Mass must be known or the reach will exit the dispatch method and wait for more information. For more information, see “Solve In Salt Given Out Salt” in Water Quality.

It is now possible to show arrow heads on links on all three canvases. Link Arrows are controlled through user-defined Link Display Groups. See “Link Groups” in User Interface for more information.

Workspace background colors for the Simulation and Accounting Views are no longer user-based settings. Instead, the background color is saved with the model. Previously set background colors are no longer used, you must reset them.

The Export Full Workspace Image function now supports a Background Image Only option.

The Workspace now provides the following object selection behavior:

The setting for the RiverWare window icon, which is set from the Workspace Utilities  Windows  Window Icon menu (four options), is now saved with the RiverWare model file. See “Icon Colors” in User Interface for more information.

Object Clusters allow you to group together simulation objects on the workspace and show only a single icon. Clusters are for display purposes only, they have no effect on the model solution. It is easy to switch between showing the objects or the cluster. See “Object Clusters” in User Interface for more information.

You can now add Text or small Images on the Simulation and Accounting Canvases. Use the right-click context menu and choose Add Text... or Add Image... Specify the text or an image, respectively. In the screenshot, the rafting icon and label have been added as an image and text, respectively. For more information, see “Add Text or Add Image” in User Interface.

Modifications were made to a large number of category and method names on objects and accounts in order to adhere to a standard naming format. This included formatting all names in title case, including spaces between all words, removing terms such as “category”, “calculation” or “calc” from the names and in some cases making the name more descriptive of what the method does. Expect a large number of warning messages notifying you of the name changes the first time a model is loaded in RiverWare 6.5. These messages will include the text “Replacing old category name” or “Replacing old method name” for each changed name on each object. There should be no change in model behavior or results. Once the model is saved in RiverWare 6.5, the warning messages will not appear for subsequent model loads.

All name changes are listed below in the following six tables:

The following bugs have been closed for this release. For more information on any bug, see the CADSWES website. The bugs are listed in order by bug number: