RPL
Diagnostics for Rules/Goals
For rule diagnostics, the rule's priority was added to the display text. For initialization rule contexts, the initialization rule's index was added to the display text.
Now, the formats are:
• Optimization goal: GOAL: (<priority>) <goal name>
• RBS rule: RULE: (<priority>) <rule name>
• Initialization rule: RULE: (#<index>) <rule name>
Within the RBS and Optimization diagnostic settings dialogs, the rule and goal filters were enhanced to include and show the new context information.
Display Settings
RPL Display Settings, including Font, Colors, and Line Breaks, are now saved in the model file instead of in user settings. When you first open and save your model in this version, the RPL Display Settings will be saved in the model. You can export or import settings as needed. For more information, see Formatting: Display Settings in RiverWare Policy Language (RPL).
Element Numbering
To make it easier to find and communicate about RPL logic, you can now number the statements and expressions with which rules and functions are composed. RPL Element Numbers can be optionally shown in a column along the left side of each RPL frame or as a right-click context menu. Show these numbers from the RPL Display Settings.
For more information, see Element Numbers in RiverWare Policy Language (RPL).
ELSE IF Branches
ELSE IF operators were added to both RPL Expression and the RPL Statements. You can add these operators to any IF or ELSE expression or statement as new ELSE IF branches.
RPL Debugger
The following changes were made tot he RPL debugger:
• The Run Status is now shown as part of the RPL Debugger as shown to the right.
• Long lists are no longer truncated in the Value of Selected Expression panel. The debugger now displays the full list.
• Commas in numbers are now shown in the RPL Debugger.
Rename Variable or Argument
A new right-click “Rename...” operation was added to RPL to provide an easy way to rename all the occurrences of the selected variable or argument name.
Variables are associated with statements (FOR and WITH), expressions (FOR and WITH), or functions (argument names). For more information, see Renaming Looping Variables and Function Arguments in RiverWare Policy Language (RPL).
RPL Set Comparison Tool
The RPL Set Comparison Tool compares two RPL sets and shows you the differences between the sets. This allows you to see where items are different, what the specific differences are, and allows you to easily access the RPL set dialogs so that you can change one or both sets.
The comparison tool was improved to highlight multiple differences within the same item and note how many differences occur.
For more information, see Tour of the RPL Set Comparison Tool in RiverWare Policy Language (RPL).
RPL Notes
On RPL dialogs, a new Notes panel was added. Notes, like Descriptions, can be entered in a panel at the bottom of the dialog. Notes can be used when you have information about the RPL item that you want to enter that doesn’t belong in the Description field. For example, development information (E.g. who, why, when changed) could be entered in the Notes panel. Notes can be included in model report outputs using the RPL items and the Show Notes setting.
Notes are described in Notes in RiverWare Policy Language (RPL).
RPL Dialog - Description and Notes Indicators
The RPL dialogs were improved to better show Descriptions, Notes, and the presence of non-default values in the row of toggles. Now, when the description or notes panel contains text, the checkbox label is bold. When the panel is empty, the text is grey. In addition, when a description or notes exists, the tooltip on the text and checkbox shows the first 140 characters of the text.
Revised: 07/09/2023