RiverWare 6.1: User Interface enhancements for Post-Run Dispatching
Phil Weinstein, CADSWES -- 3-25-2011 -- (minor edits: 4-06-2011)
-- PDF
The enhancements to the user interface for support of Post-Run Dispatching generally involve the role of the run period start and finish dates in various series-data related displays and analysis computations. These include:
|
The plot dialog supports two new toolbar icon buttons. These new operations are also in the Graph menu. They are enabled only when the bottom axis represents time.
A new "Initial Time-Axis Auto Scaling" configuration option, saved with the model file, indicates whether new series plots should initially be zoomed to the full extent of the series slot data or to the Run Period. This new setting can be made in the Axis Default Configuration Settings dialog (see image). As before, this dialog is accessible via the Plot Dialog: Edit >> Preferences... >> (Plot Dialog Settings dialog) >> Default Axis Settings... This initial zooming is applied when Slots are added to a new or empty plot graph. Technical: The RiverWare 6.1 model file format now contains one of these records to indicate the value of this setting, i.e. for the Full Slot Data Range ("F") or the Run Range ("R"): PlotInitTimeAxisAutoScaleChar
{F} |
 |
The Filter settings in the Statistical Table Slot dialog now contain three radio buttons to choose between three ways of filtering the input series data:
Only the "Run Range" option is new. The former functionality supported either of the two other options ("Slot Data Range" or "Specified Range") depending on the former "Time Range" checkbox. The chosen option is interpreted (with actual begin and end date/times) and applied at the time of evaluation of the Statistical Table Slot. Newly created Statistical Table Slots default to the "Run Range" filter mode. In the Statistical Table Slot dialog, information about the Range option is now always shown in the Filter description field. (Previously, range information was shown only in the case of a Specified Range). Now, both the Time Range mode AND the resulting begin and end dates are shown -- as illustrated in the screenshots below. |
 |
Technical: The RiverWare 6.1 model file record associated with each Statistical Table Slot in the model was modified to support the new time range filtering choices. The following changes have been made:
(1) A boolean flag (encoded as "0" or "1") indicating that a Specified Range is being used has been changed to a single character code.
| OLD: | '0' | -- range filter off (uses the Full Slot Data range) | |||
| '1' | -- range filter on (uses Specified Range) | ||||
| NEW: | 'R' | -- Run Range | |||
| 'F' | -- Full Slot Data Range | ||||
| 'S' | -- Specified Range |
(2) The "Specified" time range values (beginning and edit date/times) are always included, i.e. even if "Specified Range" is not the current filter. In new Statistical Table Slots or old imported slots, the "Specified" time range values are arbitrarily initialized to the Run period.
Timestep Date/Time spinners in the following dialogs are no longer constrained to the current Run Range. (Except for the first case, these spinners are used for series data timestep navigation).
Technical: Some fixes needed to be applied to allow time scroll operations (e.g. global time scrolls initiated from some other dialog) to function outside of the current Run Range.
Additional Pre-run Timestep and Post-run Timestep dividers were added to these three dialogs:
The Open Series Slot Dialog supported only automatic regular (calendar-) period dividers. The regular period divider type depends on the series timestep size, e.g. daily series have regular period dividers between months. Regular period dividers are shown in green, and are unconditionally shown*. Now, Pre-Run/Run and Run/Post-Run Dividers are also unconditionally shown*. Pre-Run/Run dividers are blue. Run/Post-Run Dividers are red. *However, only dividers between timesteps within the dialog's series data range appear in the dialog. |
 |
The SCT had supported both Pre-Run/Run dividers and Run/Post-Run Dividers. But the two divider types had a single user-configurable color. Now these two divider types have independent configurable colors.
The "factory" (hard-coded) default for these two divider types are as follows:
However, new SCTs are created with the user's saved defaults. The factory default settings can be recovered by clearing the SCT's default settings. This is done in the SCT by selection Config >> Defaults >> Clear Default Settings. See below.
Technical: The RiverWare 6.1 SCT file format now has a record for the Post-Run divider color. Note that SCT config files are loaded using Flex/Bison processing (rather than Tcl processing, which is used for model files). Here the new record with the default "RGB" color value (dark red):
COLOR_POSTSIM_TSTEP_DIV 170 0 0
Before this change, the Run Analysis dialog ornamented "Pre-Run" timestep rows and columns in two ways:
With this change, similar ornamentations are implemented for "Post-Run" timesteps, in Red.
 |
|
The number of Post-Run timesteps is established within the "Simulation Run Parameters" dialog (accessible from the Run Control dialog). See the "Number of Post-Run Dispatch Timesteps" integer spinner. |
 |
|
| --- (end) --- |