In RiverWare, a common selector dialog is used to select objects, slots, accounts and supplies. The selector can be used for the following activities:

The appearance of the dialog depends on the required selection and the application from which the selector is invoked. For example, in any one invocation of the selector dialog, the user will be selecting only objects, only slots, or only supplies, etc. The following document describes how to use the dialog in each of the selection modes.

When creating a selection, the user starts with a general set of items and narrows it down until they can select the item they wish. In general, this is done from left to right and top to bottom. There are two main actions the user must take when making a selection: displaying the items and selecting them as described in the following section.

Displaying items is accomplished from general to specific. If the user is selecting a slot, they first start on the left by highlighting one or more Object Types, and then they are able to highlight a specific object or set of objects, and then they are able to highlight the specific slot or set of slots on those objects. These items are displayed by selecting the appropriate Object Types, Objects, and Slots or using the All buttons to select all. In Figure 7.1, we have highlighted all Reservoirs (including Level Power and Storage) in the left most pane. Then we have highlighted the Big Reservoir object in the center pane. Shown in the right pane are all of the slots on this object.

The filters for each type of selection (Objects, Slots, Accounts, and Supplies) is described in the each selection’s section.

After displaying a set of items, the user must then select the desired ones. Selecting the items consists of highlighting the desired items and selecting OK or Apply. The All and Invert buttons help the user select all items or invert the selection items. Depending on the application, the user can also select one item, select Apply, then make additional selections finally selecting OK or Cancel.

Also, in certain situations, wildcards are allowed to select all of the displayed items; see “Wildcards” for details.

In the above example, to select the Storage slot, we highlight the line Big Reservoir Storage and select OK or Apply.

Many actions in RiverWare require the user to select an Object. For example, on the Workspace, then Objects, then Select Objects menu, the user can highlight a set of objects which can then be deleted, added to a subbasin, etc.

Filters can be enabled through the Show/Hide Filter Options button. These features exist for each of the various configurations of the selector dialog (object selector, slot selector, account selector, and supply selector).

The Object Name filter field allows the user to type a part of the object name and use wildcard symbols (i.e. *) for name completion. For example, typing Lake* in the Object Name field will display only those objects that begin with “Lake”. By default, a * exists in the Object Name field and all objects will be displayed.

Table 7.1 summarizes the Object selector filters.

If appropriate, for example when selecting objects in the Diagnostics Settings dialog for filtering diagnostics by object, the All Objects and No Objects buttons will be available. If either of these options are selected, either all of the objects (regardless of filtering or selections) or none of the objects are automatically selected and the dialog is closed.

Selecting slots is one of the most common operations in RiverWare, whether for plotting, snapshots, or DMI’s. To select a slot, you must also select an Object, so the Selecting Objects section is relevant here too.

When using the selector, you generally work from top to bottom and left to right. The first choice is whether to Create Selection or to Use Slot Set as shown in the image:

Create a selection if you want to choose slots on objects. Use a Slot Set if you want to use a previously defined set of slots. See “Use Slot Set” for details on this approach.

When creating a selection, you choose the object type and objects on which the slots reside. Then you choose the slots from a panel that lists the slots. Similar to the object selector, the slot selector has fields for selecting and filtering by object and object type. These sections work the same in both the object selector and the slot selector. In addition, there are toggle buttons at the top of the dialog to specify whether or not the slots are on objects, accounts, supplies, or exchanges. Depending on the invocation of the slot selector dialog (the dialog from where the selector dialog is being invoked), these options may not be present. For example, sometimes the slot selector applies only to slots on objects or slots on accounts. In these cases, the toggle options will not be present and the dialog will appear in the appropriate configuration.

Table 7.2 summarizes the slot selector filters. Any text can be entered with the wildcard asterisks (like so: *text*), then the filter will only show Slots which contain that fragment of text.

If appropriate, for example when selecting slots in the Diagnostics Settings dialog for filtering diagnostics by slot, the All Slots and No Slots buttons will be available. If either of these options are selected, either all of the slots (regardless of filtering or selections) or none of the slots are automatically selected and the dialog is closed.

When selecting columns of an Agg Series Slots, Table Slots or Table Series Slots, the Slot Column Label Filter can be used. This is available in, for example, Database DMI Name Maps where the user can select to import column 2 of an Agg Series Slot. In addition, a push button was added to highlight Columns Only on the selection. The Wildcard checkbox also works for this type of selection. A Columns Only checkbox next to the Wildcard checkbox allows the user to specify that in the wildcard selection, only the columns should be selected and not the overall slot.

Following is an example of how this could be used: A user configures 5 agg series slots to contain crop water requirements for 10 different crops. (5 slots * 10 columns = 50 timeseries) When creating a name map for use in importing via the database DMI, the user sets the filter to select each of the columns that are labeled “Crop 1” across the multiple slots. The user can then specify that “Crop 1” maps to “corn” in the database Name Map. This enables the user to set up only 10 Name Maps, one for each crop, instead of the 50 that were previously required. Figure 7.5 shows the selector with the Slot Column Label Filter, and Columns Only button and wildcard options.

In addition to the Columns: AggSeries checkbox shown in the previous example, the selector has a TableSeries checkbox. If checked, TableSeries slot columns are displayed in the selector dialog.

The Columns Only button and the Columns only checkbox behave for TableSeries slot columns as they do for AggSeries slot columns, as described above.

Slot Sets are named collections of slots. See “Slot Sets” for details. To use the slots that are in a Slot Set, select the Use Slot Set option.

With this option selected, the selector dialog shows a list of the defined Slot Sets in the upper panel.

When one of these rows is selected, the lower panel displays the slots that are contained in that set. The lower panel is for informational purposes only. There is no way to manipulate slots in the set from the selector. All edits to slot sets must be made from the Slot Set Manager.

Choose the desired slot set from the upper panel and select OK.

With Slot Sets, you can create sets that are not applicable for a particular selection. For example, in Figure 7.6, the Script action Set Scalar Slot Values requires Scalar Slots. Rows in the upper panel are disabled (dimmed and not selectable) because those slot sets contain one or more slots that are inconsistent with the selection criteria. Only the Slot Set named Reservoir Scalar Values is applicable and valid.

When selecting accounts, the selection operation is as follows: Object Type, then Objects, then Accounts. There are additional fields for filtering by account. The checkbox options allow the user to show Storage Accounts, Diversion Accounts, and/or Pass Through Accounts. Also, the Show/Hide Filter Options button enables filtering by Account Name, Water Type, Water Owner, Junior To, and Senior To.

Table 7.3 summarizes the Account selector filters.

The dialog for selecting slots on accounts is similar to the dialog for selecting slots on objects, but these slots are on accounts, so there is an additional level of selection. The selection operation is as follows: Object Type, then Objects, then Accounts, then Account Slots. Filtering options are the same as for Objects, Accounts, and Slot. Figure 7.8 shows the selector.

When selecting supplies (accounting links), the selection operation is as follows: Object Type, then Objects, then Accounts, then Supplies. The dialog for selecting supplies is similar to the dialog for selecting slots on accounts. The same filtering options exist for object type, objects, and accounts (see the previous sections for these details). However, the section of the dialog for selecting supplies is a bit different. The user has the option to either show supplies from the specified accounts or to the specified accounts. Then supplies can be filtered based on Supply Types, Supply Name, Release Type, Destination, and Supply Role.

Table 7.4 summarizes the Supply selector filter.

There are two types of wildcards that can be used in the selector dialogs: wildcards in filters and using wildcards on whole selections. In each of the filters, the user can type in “*” to replace a portion of the text. For example, in an object name filter, typing Lake* in the Object Name field will display only those objects that begin with “Lake” thereby displaying Lake Mead and Lake Powell. By default, a * exists in the Object Name field and all objects will be displayed.

The second type of filter occurs in certain types of slot selections including DMI Name Maps and Database DMI’s slot selections. A Wildcard checkbox exists at the bottom of the slot selector. The wildcard indicate that every item matching the filters (i.e. the items shown) should be selected. When the Wildcard checkbox is checked, the selection buttons (All, Invert, etc) are removed and each of the displayed items are selected. This operation is useful in Name Maps/Database DMI’s as the selection becomes dynamic. For example, if you use a filter to show all slots named Pool Elevation, then specify that you want to wildcard the whole selection. you can then import/export all slots named Pool Elevation. If you then add a reservoir to the model, the new reservoir’s Pool Elevation slot will then be part of the selection because of the wildcard and imported/exported as defined.

The best way to learn how to use the selector dialogs is to experiment with the various filters, checkboxes, and options. Shown in the following sections are examples of common selections.

A modeler might wish to find all of the slots in a model that have a certain attribute. The modeler might need to change all of these slots or might just wish to show them all in one SCT. Example 7.1 illustrates this type of action.

From the main workspace, select Workspace, then Slots, then Open Slot to bring up the slot selector.

Figure 7.10 shows the slot selector configured to select slots with this unit type.