RiverWare 6.1: Unit Schemes
Value Display Attribute Scheme Editor
Phil Weinstein, CADSWES.

Document History / Status:

• 7-06-2011: Initial writing in progress. (See mockup screenshots).

Contents

1. Overview
2. Mockup Image: Value Display Attribute Scheme Editor Dialog
3. ... ... ...

Overview

A "Value Display Attribute Scheme Editor" dialog shows and allows the editing of a Mapped Display Attribute Scheme instance. The "mapped" schemes are those which are defined as a set of "scheme rules" which map slot and slot-column selection criteria to Display Attribute Groups. This includes all schemes other than the "Local Scheme" which uses the display attributes configured on each slot and slot column.

The dialog supports these general capabilities:

• Creation of a new empty scheme.
• Creation of a new scheme by duplicating an existing scheme.
• Renaming of user eefined schemes
• Saving and loading the scheme to and from files
• Adding, removing and editing individual scheme rules of these four types:
  1. Unit Type scheme rules
  2. Slot name-based scheme rules
  3. Column name-based scheme rules
  4. Slot name and column name-based scheme rules
• Copying and pasting of individual and sets of scheme rules via a clipboard.
• Some display fitering and sorting of scheme rules.
• The ability to make the viewed schme the "active" scheme within the session. The effectively applies the viewed scheme to all slot displays in the RiverWare session.

Mockup Image: Value Display Attribute Scheme Editor Dialog

Note: The item order shown here does not correctly represent an actual sorted state.

Switching between defined schemes

The user is able to switch between the different Mapped Value Display Attribute Schemes defined in the model using the illustrated combo box. If there are any unapplied edits in the dialog when operating this combo box, the warning popup dialog is shown allowing the user to:

• Abort swtiching to the different scheme.
• Apply the changes, and switch to the different scheme.
• Discard the changes, and switch to the different scheme.

"Scheme Rule" Types

Four types of scheme rules are supported:

• Unit Type scheme rules
• Slot name-based scheme rules
• Column name-based scheme rules
• Slot name and column name-based scheme rules

All scheme rule types include a Unit Type criteria. The latter three scheme rule types can optionally be limited to a particular Simulation Object or Account Type (including the abstract "Reservoir" and "Power Reservoir" abstract classes). These generally differ in whether or not a Slot Column Reference's (SlotColRef's) slot name and column label are considered when matching the rule.

"Scheme Rule" Type Filtering

 The user will be able to either show all scheme rules within the scheme, or show only one of the four types of scheme rules, through the use of the illustrated combo box.

File Menu Operations

Scheme Rules Menu Operations

Note: When a Slot Name or Column Name having multiple unit types is selected (see below), a scheme rule for each unit type is added. Multiple unit types will exist for the following reasons:

• A given slot name or column name may apply to slots or columns on different Simulation Objects or Accounts with different unit types.
• In the case of Accounting Slots, slots (and potentially, slot columns) having defined "Alternate" units will have two unit types.

Adding a Unit Type Scheme Rule

Adding a Slot Name Scheme Rule

Adding a Column Name (Label) Scheme Rule

Adding a Slot and Column Name Scheme Rule

Scheme Rule Edit Operations

The "ellipsis" button brings up a popup menu with the following operations:

• One of the following, depending on the scheme rule type (but not for the Unit Type scheme type). These bring up the corresponding chooser, initialized to the scheme rule key value.
  • Choose a different Slot Name ...
  • Choose a different Column Name ...
  • Choose a different Slot and Column Name ...
     
• Duplicate ... (this brings up the corresponding chooser, initialized to the scheme rule key value)
• Remove
• Copy ... (to the special scheme rule clipboard)
• Paste ... (from the special scheme rule clipboard)

The Scale, Unit, Format and Precision fields can be immediatly edited.

Any changes made to the set of scheme rules marks the scheme as edited (if the new state is different from the last applied state). This effects the enabledness of the "Apply" button (disabled if there are no changes), and effects whether or not a warning dialog is shown if the user attempts to close the dialog or change to a different scheme.

--- (in progress) ---