The RiverWare System Control Table (SCT) is a customizable, editable view of slots and data in a RiverWare model. It provides five top-level tabs, or views of different types of data. Figure 8.1 illustrates.

The data displayed in an SCT is contained in the RiverWare model, rather than in the SCT. Therefore, editing data displayed in an SCT does not affect the SCT—it affects only the RiverWare model. The SCT is just a configurable window into the model.

The SCT configuration—i.e., the settings which can be saved and reloaded as an SCT—consists of the following sections:

The time range displayed by the SCT matches the RiverWare model’s Run Control configuration, plus a configurable number of pre- and post-simulation timesteps. See “Run Menu” for details.

Many SCTs may be used simultaneously within a single RiverWare session (i.e., showing distinct views into the same RiverWare model). An SCT may be used with different RiverWare models as long as the Object and Slot names are the same.

Following is an overview of the SCT and its organization. First the general areas of the SCT are discussed, then each of the tabs—Series Slots, Scalar Slots, and Other Slots—are discussed.

Menus in the RiverWare Workspace (select Utilities, then SCT) and the SCT File menu provide the following functions:

Figure 8.2 shows the SCT menus in the RiverWare Workspace and in the SCT file menu.

Create a new SCT from the RiverWare Workspace menu. Select Utilities, then SCT, then New SCT. The SCT initially will have the user-defined default configuration.

After creating a new SCT, the Edit Series Slot List tab is shown (see “Edit Series Slot List Tab”). If you are adding slots to the Series Slots tab, you will want to add Slots and Slot Dividers. Otherwise, you can cancel and go to the desired tab to begin configuration. See “Add Slots, Sheet Tabs, and Slot Dividers” for details.

The SCT menu bar is described in the following sections.

The SCT File menu supports the following operations:

The SCT Edit menu supports the following operations.

The behavior of the Copy and Paste operations depends on the nature of the current selection within the SCT. See the following topics:

The SCT Slots menu supports the following operations:

The SCT Aggregation menu allows you to aggregate the data up to a larger timestep. For example, for an 1 Hour timestep model, aggregate and show values at a 1 Day timestep. The following operations are available in the Aggregation Menu:

The SCT View menu supports the following operations.

The SCT Config Menu allows you to access the configuration settings. The menu choices open the configuration dialog to the specified tab. See “SCT Configuration Settings” for details.

See “Use the Default Configuration” for details on the Defaults operations.

The DMI menu includes all defined Input and Output DMIs and DMI Groups, along with I, O, or G icons. The menu has a checkbox to switch between the presentation of all items in the single top-level menu (if there aren’t too many items), or cascaded into three menus. Choosing a DMI or Group will invoke that DMI! You can also show the DMI Manager from this menu.

The SCT Run menu and toolbar buttons allow you to make a run directly from the SCT.

The SCT Scripts menu allows you to access scripts directly from the SCT.

Use the Script Management menu to open the Script Manager. Or use the menu options for each named script to open that script’s dashboard dialog.

The Diagnostic Output window can be shown as a panel at the bottom of a single SCT or as a stand-alone window. It will appear in only one place at any given time. Diagnostics can be enabled in or out of the SCT using the stethoscope icon in the SCT toolbar or the SCT Diagnostics menu.

To reduce the amount of vertical space taken up by the Diagnostic Output panel, you can hide the Diagnostic Window’s integrated menu/toolbar. The menu operations in integrated menu-/toolbar are also available in the SCT Diagnostics menu.

When a run is started, the selection status area of the SCT is replaced with the a display of the run status (if that is enabled in the SCT configuration). This is displayed until you select somewhere in the SCT table or select Dismiss. Unlike the Diagnostic Output, the Run Status will simultaneously be displayed in multiple SCTs and as a stand-alone dialog. However the stand-alone popup is not automatically raised if the Status can be displayed in an open SCT (i.e. by showing and raising any SCT which is already open).

Also shown in the Run Status area is information on the dispatching of objects within the run. An icon is shown that displays the most limiting dispatching of objects within the run. Also displayed are the number of objects that meet the most limiting condition.

Selecting the icon takes you to the Model Run Analysis tool (see “Simulation” in Debugging and Analysis for details), with the first relevant object at the earliest timestep highlighted. When you Shift-Click on the icon, a dialog is shown with a summary of the run analysis. Listed are the objects and numbers of objects that have dispatched, dispatched but not solved, and those that have not dispatched.

The SCT Go To menu allows you to scroll to named locations in the SCT. This can be useful when an SCT has a large number of slots that do not fit on a single screen.

Most of the settings for an SCT are controlled through the SCT Configuration dialog, which you can access from the Config menu. All options will open the configuration dialog but depending on the menu selected, the appropriate tab will be enabled.

The properties this dialog supports are described in the following sections:

To display the SCT Configuration dialog, select SCT Config, then General.

To display the SCT Configuration dialog, select SCT Config, then Horz Time.

These settings affect the appearance of the horizontal timestep axis orientation views (time on top).

To display the SCT Configuration dialog, select SCT Config, then Vert Time.

These settings affect the appearance of only the vertical timestep axis orientation views (time down the side).

To display the SCT Configuration dialog, select SCT Config, then Font.

In this tab, you can choose the SCT font. Only one font can be displayed at any given time, and that font is used for both screen display and printing.

To display the SCT Configuration dialog select SCT Config, then Toolbar.

These settings control which toolbar buttons are displayed in the SCT Toolbar. See “SCT Overview” for details.

The operations associated with each of the configurable toolbar buttons are also represented in the SCT menus.

To display the SCT Configuration dialog, select SCT Config, then Summary.

The settings on this tab allow you to change the colors shown when timesteps are aggregated. See “Change Ornamentations” for details on the Show Timestep Flag Colors options.

The Flags tab is used for three types of settings related to the support of slot timestep flags in the SCT.

Use the following steps to edit the definition of custom colors.

See “Apply Custom Colors to Slot/Timestep Cells” for details on applying the custom colors to specific cells in the SCT. See “Configure Color Alerts” for details on using the custom colors for Alerts (i.e. conditional formatting).

The Color settings tab lets you configure colors, other than flag colors that are set on the Flags tab (see “Flags Tab” for details).

For an explanation of these settings, see the following topics:

Series data is represented in a spreadsheet view on the Series Slots tab of the SCT. This table supports swapable axis (slots vs. timesteps) and optional timestep aggregation. The following screenshot shows the areas of the Series Slots tab. Row Headers and Column Headers provide the slot label, units, aggregation information, and timestep information. Columns and rows are swapable so this information is displayed differently depending on the orientation.

Further, you can organize your series slots into user configurable sheets where there is a tab at the bottom of the SCT. When there are multiple sheets, there will always be an All Slots tab that shows all of the slots on one tab. You can tear off or show any sheet as a new SCT. See“Create a new SCT from a Series Sheet tab” for details.

At the bottom of the SCT is the Selection Info Area also called the Summary area. This displays information on the selected cells in the SCT including the name or number of slots and then statistics on the selection. Statistics include Sum, Average, Median, Min, Max, Range, and Difference. All, some or none of these may be shown depending on the number of cells selected and the units of those cells. Figure 8.3 shows the areas of the Series Slots tab of the SCT.

Either rows or columns (depending on the current axis orientation) correspond to slots and slot dividers. See “Axis Orientation” for details.

RiverWare slots are identified with a fully qualified name (including the name of the simulation object, account, or other entity the slot is on). SCT slots for which a match cannot be found on the workspace are indicated as disabled—no data is shown, and you cannot provide data for such slots. See “Slot Names and Slot Labels” for details.

Properties associated with slot items (within the SCT configuration) include the following:

There are two kinds of dividers you can add to organize your SCT, as follows:

See “Change Ornamentations” for details on changing background colors.

In Figure 8.4, thin slot dividers display as blue, while sheet dividers are pink. Each graphic shows multiple tabs and two slot dividers.

See the following topics for more information:

RiverWare uses Slot Names to refer to a particular slot. Generally, the slot name includes the simulation object or account that the slot is on. You cannot change a slot’s name within the SCT. (Simulation slots cannot be renamed; custom slots can be renamed from the open object dialog.) See “Ornamentation of Hidden Pre- and Post-Run Timesteps” for details.

Slot Labels are text strings that you can use to label a slot within a particular SCT. Two slot labels text strings are associated with a slot item, as follows:

In the horizontal timestep axis orientation (where slots are rows), if the SCT is unlocked, you can edit a slot label in-line. In either orientation, you can edit a slot label by selecting the slot (e.g., select a data cell within the slot) and then selecting Slots, then Set Label / Function; see “Slots Menu”.

You can set the label for multiple slots to standard values; see “Edit Multiple Slot Labels” for details.

Slot Labels are always visible within the SCT as either row or column headers. If the current SCT selection includes only a single slot, the name for a slot displays in the Selection Info area (at the bottom of the SCT).

In the following examples, one slot is selected (by virtue of one of its timesteps being selected). See “Vertical Timestep Axis Orientation” for details.

Although numeric slot (time series) values are stored internally as double-precision floating point numbers, values are presented in the SCT (and elsewhere in the RiverWare interface) with a display precision. Display precision is a non-negative integer that specifies the number of fractional decimal digits (to which the internal value is rounded). The SCT uses a slot’s display precision for all data cells.

The values displayed in a slot are in the units displayed elsewhere for the slot as defined by the Unit Scheme. The SCT does not provide the ability to change display units of slots.

If you select a single value, it is redundantly displayed with model precision in the Toolbar Value Edit field, where it can also be edited. Model precision is not necessarily the full precision of the internal value.

Slot values can be in an undefined state. Depending on an SCT Configuration, undefined values can be displayed as NaN (which stands for Not a Number) or as blanks. See “General Tab” for details.

The SCT also shows tooltips indicating which rule or DMI was responsible for the value, where applicable. See “Series Slots” for details.

The SCT always provides an alternative units (Alt Units) toggle button on the toolbar as shown in Figure 8.5. The button provides the following display options:

All flow series slots on the SCT can be displayed as volume over the timestep using the default unit scheme definition for volume. Certain volume slots can be shown as flows. See “Alt Units button” for more information.

You can define and apply custom cell colors for series slots. Use one of the following approaches:

When applied, the configured text and background colors are shown on the SCT instead of the standard flag colors. Tooltips provide the flag information and the custom color label or interval name, as shown in Figure 8.6.

The SCT supports timestep annotations on the Series Slots tab. Operations on Notes are performed with the right-click context menu, with the same operations as those available in the Open Slot dialog. See “Notes on Series Slots” for details.

If a single SCT cell is selected, the note text associated with that cell are displayed in the SCT selection status bar, at the bottom of the SCT. As with the series data shown in an SCT, the notes are associated with the SeriesSlots shown in the SCT, and not with the SCT itself.

When the SCT is in the Non-Aggregated Vertical Timestep view (see Figure 8.7), the text for all of the notes in each timestep row can be shown in a row header column, depending on the setting on the Vert Time tab of the SCT configuration; see “Vertical Time Tab” for details.

An SCT can be configured to show a timestep interval matching the RiverWare model’s Run Control or any other timestep supported in RiverWare. This feature is configured using a SCT Timestep Size Override property which is configured on the General tab of the SCT configuration dialog. See “Run Menu” for details.

In addition, the timestep range of slots in an SCT do not have to match Run Control; SCT cells corresponding to a timestep on a slot that is out of that slot’s defined range display merely as blank.

Conversely, the displayed timestep range of the SCT—the model’s current run control timestep range plus the indicated number of pre-simulation and post-simulation timesteps—may not cover the complete timestep range of slots displayed in the SCT. When this occurs, a special ornamentation (an upper-left or lower-right corner triangle) on the slot’s first and/or last cells indicate the presence of obscured (hidden) timestep values for that slot. See “Ornamentation of Hidden Pre- and Post-Run Timesteps” for details.

For display (and certain data export) purposes only, groups of timesteps within each Slot can be aggregated and summarized as single numeric values within an SCT. Aggregation is done by choosing an aggregation interval size larger than the timestep interval size—for example, aggregate 1 Hour timestep data up to a 1 Day timestep. It is also possible to select a constant number of timesteps for aggregation. See “Timesteps” for details.

When in an Aggregated View, each slot displays only the summary cells.

To configure the aggregation, access the SCT Timestep Aggregation Configuration dialog by selecting Aggregation, then Timestep Aggregation Config. See “Aggregation Menu” for details.

Within the dialog choose one of the following:

With interval aggregation, the number of timesteps per aggregation can vary for the following reasons:

The SCT supports both non-aggregated and aggregated views. In non-aggregated views, every data cell displays the value of exactly one timestep. Aggregated views have both detail and summary cells. These are described in the next section.

Aggregated SCT views display the following types of data cells (see “Timestep Aggregation” for details).

In both axis orientations, summary cells and detail cells have the same relative arrangement. An aggregation’s detail cells (showing each of the individual timesteps within the aggregation) are laid out immediately below the aggregation’s single summary cell. Also, the two types of cells are laid out in rows—i.e., Summary Rows and Detail Rows—though the correspondence of those rows to the same slots versus the same timesteps differs in the two axis orientations. See “Axis Orientation” for details.

In the aggregated views, summaries are always displayed while detail cells can be displayed or hidden. The non-aggregated views display only details without summaries.

You can select a Summary Function for slots in the model based on the unit type, slot name or individually for each slot in an SCT. The function is applied to the set of timesteps within each timestep aggregation and displayed in a Summary cell. See “Timestep Aggregation” and “Detail Cells and (Aggregation) Summary Cells” for details.

The following Summary Functions are supported:

For the arithmetic functions, undefined values (NaNs) are ignored.

How To:

For time-aggregated, vertical timestep view (where slots are columns), you can specify one or more custom Summary Rows at the end of each time aggregation.Figure 8.8 shows eight custom rows (including dividers as the first and last custom summary rows).

The following custom summary row types are supported.

Each custom summary row can be configured with a unique background color. To display the Custom Aggregation Summary Rows configuration dialog box, select Aggregation, then Custom Summary Rows.

Each row is configured through these controls.

These contain the following additional controls to identify a particular series slot (of the aggregation size) or scalar slot for each simulation object column. The primary reference simulation object will be the object containing the SCT column's associated series slot. The reference slot must have the same unit type as the slot. If they have different unit types, no data will be shown in the reference row. The additional controls are:

The Custom Summary Rows support only single-cell selection, and such a selection is active only if no other SCT cells are selected. The Custom Summary Row cells are primarily read-only, but the read-only cross-hatch is not shown. Custom Summary Row cells are automatically updated whenever changes to any of the other SCT cell values change. In the case of Slot Reference rows, changes to the referenced slot are also automatically reflected.

The content of a custom summary cell can be hidden by right-clicking the cell and selecting Hide Aggregation Value. This can be useful to hide the aggregation if it does not make sense for a particular slot. A cell value hidden in this way can be reshown by selecting the Show Aggregation Value context menu operation.

All such hidden cell values can be reshown with an operation in the configuration dialog accessed from the Aggregation, then Custom Summary Rows The Hidden column lists the number of hidden slot values. Hover over a number to see the slots hidden. Select the Clear Value Hiding button to show all values.

Use one of the following methods to swap the two SCT axes:

You can display either axis orientations as Aggregated or Non-Aggregated views (see“Timestep Aggregation” for details).The axis orientations are referred to in the interface and in SCT documentation as vertical or horizontal timestep axis orientation.

See the following topics for descriptions of the types of Copy and Paste that can be done in an SCT:

The default Copy operation (Ctrl+C) copies the selected cell’s values to the INTERNAL RiverWare SCT clipboard (i.e. it is available only to the SCT not elsewhere in RiverWare or other applications). The copy action is only available for selection within a single slot or across one or more entire timesteps. The default paste operation (Ctrl+V) (and the Paste toolbar button) pastes only Input values into the current selection. Values computed as a result of a model run are not pasted. Specifically:

The default Copy operation (Ctrl+C) copies the selected cell’s values to the INTERNAL RiverWare SCT clipboard (i.e. it is available only to the SCT not elsewhere in RiverWare or other applications). The copy action is only available for selection within a single slot or across one or more entire timesteps. Selecting Edit, then Paste as Input (also, Ctrl+N) pastes all defined (non-NaN) values from the copied (source) selection to the destination timesteps, assigning the Input Flag to those values. Undefined (NaN) values from the copied (source) selection are pasted as NaN / Output Flagged values in the destination timesteps.

The Export Copy operation copies the selected cell’s values to the SYSTEM clipboard (i.e. it is available for any other application and within RiverWare where an Import Paste is supported). Select Edit, then Import Paste to paste all defined (non-NaN) values. Both operations provide a dialog that gives options on what to export/import.

See “Copy/Paste Data to/from the Clipboard (e.g., to Excel).” for additional information on using Export Copy and Import Paste.

Up to this point, we have presented the SCT and assumed that the you are always displaying timeseries data. It is also possible to display integer indexed slots. See “Integer-indexed Series and Agg Series Slots” for more information on Integer Indexed Series Slots. An SCT can show integer indexed slots, but because a SCT must have the same timestep size for all slots displayed, it cannot also show time indexed slot. As a result, you are prohibited from adding integer indexed slots to a SCT that already has time indexed slots and vice versa. When an SCT is created, if you add an integer indexed slot, that SCT becomes fixed using integer indices. An Integer Indexed SCT is slightly different than a normal SCT because certain operations are not allowed. The following describes the differences when an SCT is displaying integer indexed series

The Edit Series Slot List tab contains a list of series slot columns shown in the Series Slots tab and consists of two modes:

These two operations are described in the following sections. For both modes, the dialog shows a two-level tree-view with dividers as top-level items and subsequent slot items as children of the divider.

When in Add / Delete Move Series Slots mode, this dialog is used to organize your series slots. You can re-arrange the order, create groups, and even create separate sheet tabs from this dialog. There are two kinds of dividers:

Both types of dividers behave the same in this dialog in terms of moving and creating similar groups. The slot list has an initial divider item so there is always at least one group.

Following is a description of the buttons available on this tab:

The SCT must be unlocked for any operation to be enabled. If the SCT is locked, the Edit Series Slot List tab is disabled.

When showing the Edit Series Slot List tab, the SCT Lock controls (toolbar button and menu item) become disabled. The other SCT tabs remain enabled until a change is made to the Series Slot list.

Once a change is made to the Series Slot list, the other tabs become disabled. You can Revert or Accept the changes.

In general, use the Insert or Append buttons at the bottom.

Alternatively, use the right-click context menu to access a list of possible actions.

Slot Dividers can be added at either the top or secondary level. Sheet Dividers are always added at the outermost level.

Two different move modes are supported. You can switch between these two modes by toggling the Move Groups checkbox. Selected items or groups are moved up or down one logical position (defined by the mode) by selecting the Up or Down arrow buttons.

Since the text label for a slot item does not have to be the name of the slot, you have the option of showing a Slot Name column. This is done by turning on the Show both Slot Labels and Slot Names checkbox.

The Create Similar Groups button is used to create a group of slots similar to the selected group. The button is enabled when the selection applies to slots on one simulation object or account. Selecting the Create Similar Groups button displays a selector that you use to select new objects or accounts.

In the case of simulation objects, the object selector is limited to the type of the object of the originally selected group.

After picking one or more simulation objects or accounts, a new group is created for each of those objects (immediately below the originally selected group in the Edit Series Slot List) with the same slots as in the original group. The order of the slots in the original group is used for the new groups.

In Figure 8.9, the original group has slots from one particular power reservoir (Abiquiu Reservoir). This includes slots not present in the two storage reservoirs subsequently picked with the simulation object selector. The slots from the original group that are not present in the picked reservoirs are not included in the new groups.

If the original group's divider's text label contains the name of the group's simulation object or account, that name will also be substituted in the divider labels for the new groups.

The Create Similar Groups operation is available only when all the slots within the selected group are from one simulation object or one account.

As noted in “Slot Names and Slot Labels”, a slot’s label does not need to match the Slot name. Select Slots, then Set Label / Function and enter any text you like for either the row or column label. See “Slots Menu”.

When on the Edit Series Slot List tab, you can set the labels for many slots in one action. Highlight the desired slots, and right-click, then select Set Labels to. Select one of the following options:

When Configure Color Alerts is enabled, the slot list is used to configure the interval/thresholds and colors to use for those values. The intervals and their associated colors are defined for individual series slots.

Right-click a slot and select Edit Slot Thresholds context menu to open the SCT Color Alert Threshold Configuration dialog box. This is also accessible from the Color Alert Thresholds button, enabled when a single slot item is selected.

Add intervals using the Plus button. Remove an interval using the Minus button.

For each value interval, you choose among the available Custom SCT Cell Colors defined in the SCT Flags tab or the <default> option, which uses the color associated with the slot timestep cell's series flag. The custom colors can be edited by selecting the Custom Cell Colors button. See “Flags Tab” and “Custom Cell Colors” for details.

The upper threshold for each interval can be specified as either a static numeric value or you can reference a slot. Select one of the following options:

After accepting the SCT Color Alert Threshold Configuration, the slot's sequence of value intervals is shown as tree view items under the slot.

Table 8.1 describes the color values used in the previous examples.

A slot's set of value intervals can be copied to multiple other slots with the use of the Copy Slot Threshold and Paste Slot Thresholds right-click context menu operations.

The Scalar Slots and Other Slots tabs display lists of slots. They are used to organize non-series data allowing you to collect these slots together in a convenient location. For example, instead of opening each reservoir and looking for the Elevation Volume table, these can be grouped together on the Other Slots tab.

All slots on the list can be opened and edited from their individual slot dialogs. Also, one or more scalar values can be edited directly from the SCT. The slots are sorted using the same approach used in “Scalar and Other Slots Tabs: Slot Lists”.

Non-series slots are added to the SCT in the same way that series are added. See “Add Slots, Sheet Tabs, and Slot Dividers” for details.

This section describes the two Slot List tabs and their functionality.

Slots in the Slot List Tabs maintain a custom order. You can change this order or temporarily override it by selecting a column header, which re-sorts, or reverses the sort using data in the selected column.

If the list is currently sorted by the custom order, then Up and Down arrow buttons are shown to move the selected items up or down. These buttons immediately modify the custom order.

If the list is not currently sorted by the custom order, the following two Custom Order operations are available (see image)

Instead of showing a column for the object and one for the slot, you can instead Compress the names into one column. This is controlled by a Compress Columns box at the bottom of each Slot List Panel.When checked, slots are identified with a single complete name.

Compare Figure 8.11 with Figure 8.12.

The Scalar Slots tab is used to show a list of Scalar and 1x1 Table Slots.

The values of Scalar Slots and 1x1 Table Slots can be edited from the SCT Scalar Slot List tab in the following ways.

The Other Slots tab can be used to display a list of other types of slots including Table Slots, Periodic Slots, Statistical Table Slots, and List Slots. These slots are not editable directly from the SCT, but can be easily opened using the Open Slot button.

The SCT Object Grid tab presents a user-configured grid of simulation objects. Each Cell represents one object. Scalar slots and single-cell table slots are displayed (and are directly editable) as a list of slots within the cell. These are referred to as Cell Slot Lists.

In the Object Grid, you can:

Very few of the SCT menu bar and toolbar controls operate on the object grid. Currently, the only SCT controls outside of the Object Grid tab that operate on the object grid are accessed by selecting View, then Fit Data Columns, to auto-adjust grid row and column sizes.

The configuration controls are enabled only if the SCT is unlocked, using the Lock Toggle button on the left side of the SCT toolbar). The primary configuration controls are optionally shown at the top of the object grid, based on the Configure group box checkbox.

Enter a value or use the selector controls to specify the number of rows and columns in the grid.

The Insert Row and Insert Column buttons are enabled when the cell selection is limited to a single row or a single column (including the case of just a single cell being selected). Use those operations to insert an empty row above, or an empty column to the left of the selected row or column.

The Remove Rows and Remove Columns buttons are enabled when whole rows or whole columns are selected (e.g. by selecting, or dragging along the row or column headers).

When one or more cells are selected, use the Cell Object Set button to open the Object selector. Each time the selector’s Apply button is selected, the chosen object is assigned to the first selected cell, and that cell is deselected. This allows the assignment of objects to multiple cells with a single invocation of the selector. The first selected cell is the topmost selected cell in the left-most column containing selected cells. (The assignment sequence proceeds downward in the left-most column until all selected cells in that column have been assigned objects).

It is valid to assign a particular simulation object to multiple distinct cells. Each of those cells could potentially show different slots from that object.

The Cell Object Clear button is enabled when one or more defined cells (having simulation objects) are selected. This operation removes the selected cells’ simulation object (and slots).

The four arrow buttons shift the set of selected cells one position in the indicated direction.

When the current cell selection contains at least one defined cell (having an associated simulation object), use the Cell Slot Lists controls to modify the slots shown for the cell(s). The Add, Edit List and Copy buttons are enabled only if exactly one defined cell is selected. The Clear and Paste buttons can be applied to multiple selected cells in a single operation.

The Add (slots) button is actually a shortcut. Selecting it shows the Edit Object Cell Slot List dialog, as does the Edit List button, and automatically presses the More Slots button in that dialog to bring up the Slot Selector dialog.

The Edit Object Cell Slot List dialog edits the list of slots for a single cell. As mentioned above, this dialog’s More Slots button brings up the Slot Selector to pick physical scalar and table slots (including periodic slots) on the cell’s simulation object.

The Remove Slots button and the Up and Down arrow buttons operate on the slots selected within the list.

Returning to the SCT object grid configuration controls, the Clear, Copy and Paste buttons operate on the set of selected defined cells.

Slots will appear in a cell in basically three different ways.

Each cell has three different types of buttons:

To open and close multiple cells, you can drag the whole row or whole column to select it. Also all cells in the grid can be selected by selecting the square between the row and column headers in the upper-left corner of the grid.

Shift-Click and Ctrl-Click operation of the Open / Close button have special behaviors. Shift-Click opens up the selected cell and its four immediate neighbors. The Ctrl-Click operation also closes all other cells. A tooltip on the button reminds you of this feature.

Right-clicking in a cell shows the context menu. All of the operations, except the last two, are redundant with buttons in the Configure panel above the grid.

The Import Configuration and Export Configuration operations read or write the whole object grid’s configuration from, or to, an external file. (The file is an XML text file). This can be used for moving Object Grid configurations between different SCTs.

Selecting these two context menu items brings up a file selector for reading or writing, from which the you may cancel the operation. When importing, the current object grid configuration is entirely replaced with the imported configuration.

Use the controls along the bottom of the Object Grid to modify the data display.

The Full Precision checkbox switches between configured display attributes (e.g. a particular number of fractional decimal digits) and full precision, showing the number of fractional digits necessary to precisely represent the internal floating-point numeric value. (Full Precision is also shown automatically when a cell value is edited).

Use the Show Units checkbox to show or hide the units. When units are hidden, they are available as a tooltip on the value editor.

The Value Editor Width sets the width of slot value editors to ensure visibility of the specified number of characters. The supported range is 3 to 22. The default is 12.

When the SCT is locked, the following components of the SCT configuration cannot be changed:

The SCT can be locked or unlocked by selecting the Toolbar Locked checkbox button or Edit, then SCT Configuration Locked. See “Edit Menu” for details.

To add slots or slot dividers, the SCT must be unlocked. See “Lock or Unlock the SCT Configuration” for details.

To add slots to an SCT, use one of the following actions:

Only actual slots that exist in the currently loaded RiverWare model can be added to an SCT.

Through the RiverWare slot selector, you then select slots they want to add. Slots are added to all of the three panels using the slot Selector. See “Selector Features” for more information on the Selector. Slots of any type can be selected into an SCT. The selected slots (picked using the selector) are added to one of the three SCT Tabs, according to slot’s properties.

The SCT / Slot Selector Slot Type Filter is automatically configured for the current SCT tab. But, you can modify or dismiss the Slot Type Filter, and select any Slots. See the following image. The Slot Types filter can be used to filter by the desired type of the slot including

Once a slot(s) is selected and either the Apply or Ok button is selected, the slot(s) will be added to the appropriate tab of the SCT, and that data tab will become active.

Slot Dividers can be added directly (not using the selector) using the menus.

Add Sheet Dividers from the Edit Series Slot List tab; see “Edit Series Slot List Tab” for details.

To remove slots or slot dividers, the SCT must be unlocked. See “Lock or Unlock the SCT Configuration” for details.

Select Slots, then Remove Slots / Dividers to remove the selected slots from the SCT. See “Slots Menu”.

Slots can be removed from the SCT Slot List tab by selecting one or more slot items in the list and selecting the Remove button or using the right-click context menu.

To move slots or slot dividers, the SCT must be unlocked. See “Lock or Unlock the SCT Configuration” for details.

Series slots can easily be moved from the Edit Series Slot List tab; see “Edit Series Slot List Tab” for details.

Also, slots and slot dividers can be copied, cut, and pasted (inserted or appended) within an SCT or between SCTs (within the same model). The data copy and paste operations (under the SCT Edit menu) are not related to the slot and slot divider moving operations. Instead, the following operations on the SCT Slots menu are used. See “Slots Menu” for details.

The Insert Copied Slots / Divs operation inserts the previously copied or cut slot items immediately before the single selected slot item.

The Append Copied Slots / Divs operation appends the previously copied or cut slot items to the end of the SCT slot item list, after the last slot row or after the last slot column, depending on the axis orientation. See “Axis Orientation” for details.

The cell ornamentation (crosshatch) displayed on the copy data cell set also applies to the Copy Slots / Dividers operation.

There is no problem with having a slot represented redundantly within an SCT (e.g., as a result of inserting or appending a slot reference into the same SCT from which it was copied). You may want to do this is to see two or more distinct Summary Functions (e.g., Sum and Average) for aggregates of a particular slot. See “Summary Functions” for details.

When you have multiple Series Sheets, you may want to look at more than one sheet at a time. This functionality is supported by tearing off a Series Sheet to create a new SCT. You can then see both SCTs at once. This operation is performed as follows:

On the Series Slots tab, right-click on the sheet tab and choose Show Sheet in New SCT The sheet is now shown in its own SCT.

See “Timestep Aggregation” and “Summary Functions” for details about Summary Functions.

To change a slot’s Summary Function, the SCT must be unlocked. See “Lock or Unlock the SCT Configuration” for details.

There are three ways to change Summary Functions. The first changes the summary functions of all slots in the SCT, the second two ways are for individual slots. If you wish to set most of the slots to use one summary functions, use the Set SCT Aggregation Summary Functions first, then change other specific slots as needed.

The number of slots matched for each row is displayed in the last column.

The first matching row is used for the slot, so the order of the rows may matter. For example, in Figure 8.14, Pool Elevation is the first row using Med, and Length is the last row using Last. Thus, all Pool Elevations in the SCT will use the Med function for aggregation.

When you choose the Apply to SCT button, the matched slots are given the appropriate summary function.

See “Configure Row and Column Headers” for details on showing the Summary Function column in the Aggregated Horizontal Timestep Axis View.

A slot’s Summary Function can also be changed by selecting a single slot and then selecting Slots, then Set Label/Function. See “Slots Menu”. In the dialog, you can select a different option from the Summary Function menu.

See “Show or Hide (Aggregation) Summaries” and “Timestep Aggregation” for details.

Summary cells always display the aggregated data. To display or hide summaries, you can switch to the appropriate view in either of these ways:

Select one of the detail modes from the SCT Aggregation menu, or use the following toolbar buttons:

See “Show or Hide (Aggregation) Summaries” and “Timestep Aggregation” for details.

You can display all details by selecting the No Aggregation detail mode either from the Aggregation menu, or by accessing the detail mode toolbar buttons (see “Show or Hide (Aggregation) Summaries” for details).

In the Aggregated Horizontal Timestep Axis Orientation View, each summary row corresponds to one slot. Therefore, showing or hiding the details for a single summary row displays or hides the details for one slot.

In the Aggregated Vertical Timestep Axis Orientation View, each summary row corresponds to one timestep aggregation. The detail rows under a summary row represent the individual timesteps within each timestep aggregation. Details for a single summary row that corresponds to one timestep aggregation across all slots (where each slot is in a separate column).

In the aggregated views in Show/Hide Details (Optional Details) detail mode, you can display or hide details (detail cells) independently for each summary row in the following three ways:

You can display or hide all details (detail cells) by selecting the Show All Details or Hide All Details detail modes from the SCT Aggregation menu, or by accessing the corresponding toolbar buttons. Selecting these modes does not affect the individual summary row detail open/closed states in the Show/Hide Details detail mode.

Since the correspondence between slots and times with rows and columns depends on the axis orientation, the types of information that can be shown in row and column headers depends primarily on the selected axis orientation. See “Axis Orientation” for details.

The visibility of certain row header columns and types of information in data column headers is controlled separately for the two axis orientations through the use of two corresponding tabbed panes in the Configuration Dialog.

In the Horizontal Timestep Axis Orientation only, where rows correspond to slots, the following two in-cell edit operations are supported when the SCT is unlocked (see “Lock or Unlock the SCT Configuration” for details):

You can manually resize columns by dragging the dividers between the column headers. The following operations are also available in the SCT View menu. See “View Menu” for details.

Many, though not all, of the column width adjustments are preserved when you save and reload an SCT.

You can modify colors by selecting the Flags tab or the Color tab of the SCT Configuration Dialog. See “Flags Tab” and “Color Tab” for details.

See “Use the Default Configuration” for details on saving the new settings as default, or restoring the default color settings.

To apply custom colors to selected cells, named custom colors must be first defined and configured; see “Custom Cell Colors”. for details. Then perform the following steps to apply the colors:

Figure 8.15 shows a color definition and the colors applied to cells in the SCT.

Use the Apply Custom Colors, then Clear operation to remove those cell colors, restoring the selected cells' colors to those associated with the series flag. Custom cell colors can be cleared from the entire SCT by selecting all cells, e.g. by selecting the upper left area of the row header table and performing the Clear operation.

To apply custom colors alerts (a form of conditional formatting) for a particular slot, define the colors and thresholds for each interval. On the Edit Series Slot List tab, switch to the Configure Color Alerts mode.

Right-click the slot and choose the Edit Slot Thresholds context menu to open the SCT Color Alert Threshold Configuration dialog box. Then define the thresholds/intervals and colors. See “Configure Color Alerts” for details.

You can configure the graphical ornamentations through settings in the SCT Configuration Dialog. These settings are represented on various tabbed panes in that dialog. See “SCT Configuration Settings” for details.

You can change the Aggregation Interval by using the SCT Timestep Aggregation Dialog. This dialog is shown by selecting Aggregation, then Timestep Aggregation Config. See “Timestep Aggregation”.

The time range of the SCT depends on the following factors:

It is quite possible that the time range of any particular slot starts before the first timestep shown in the SCT or ends after the last timestep shown in the SCT. When this occurs, a small corner triangle displays in the first or last Summary cell and the first or last Detail cell in that slot. If you select such a Detail cell, the number of obscured timesteps displays in the Selection Info Area at the bottom of the SCT.

The only way to display a slot’s obscured timesteps is to extend the time range of the SCT to cover the slot’s full time range. This is done by selecting the General tab of the SCT Configuration Dialog. Increase either the Pre-Run Timesteps count or Post-Run Timesteps count by the required amount. See “General Tab” for details.

When a new SCT is created, RiverWare looks to see if there is a default.sct file defined. If so, the configuration settings from the default are used in the new SCT. Also, at any time, you can choose to either save the current settings as default or revert to default settings. The default configuration is supported with the menu operations from the SCT Config menu. See “Config Menu” for details.

The default configuration is used to do the following:

The sections above describe how to configure the SCT to look the way you wish. This section describes how to use the SCT to set values in the model. Remember, the SCT is just a window into the model, all values are stored in the model. So, this section describes how to use the SCT to operate the model.

Generally, you can directly edit data. Or you can select the cell, and then select the Entry field (at the top of the SCT) and edit the number there.

When you enter a valid (non-NaN) value, in addition to the numeric value being set on the slot timestep, generally the Input Flag is set. An exception, cells with the Target flag initially set will retain that flag.

You cannot edit certain types of slots, including expression slots and certain accounting system slots. These slots have Read-Only ornamentation. Read-only cells are cross-hatched with a user configurable Read-Only color. See “General Tab” for details.

If you want expression slots to evaluate after you edit a value, the SCT must be configured to use the Auto-Evaluate Expression Slots on Edits checkbox in the General tab of the Config menu (see “General Tab” for details). With the checkbox selected, expression slots shown on the SCT will fully evaluate (all timesteps) any time a value on that SCT is edited.

When you select multiple data cells, the value you enter is set on all cells on the selection. So, editing the active cell within a multiple-cell selection behaves similarly to setting a single value, but the value is set on all cells in the selection This can include slots having different unit types (e.g., Flow and Area). It is up to you to insure that the multiple-value setting operation makes sense. See “Set a Single Value” for details.

Since selecting a Summary Cell is equivalent to selecting all of the corresponding Detail Cells, an edit of a Summary Cell is implicitly a multiple-value edit operation. See “Show or Hide (Aggregation) Summaries” for details.

If you want to set a particular slot to a particular value (or interpolate to a value) from a start timestep to some finish timestep (often a long way out), use the Set Slot Value over Time Range dialog.

On the SCT, select the first cell in the range and right-click. Choose the Set Values over Time Range menu item.

Specify either the Last Timestep or the Timestep Count to define the time range. As you change the range, the cells are selected on the SCT. Then specify the Value to set in the units of the slot, as shown.

The three buttons are as follows:

To linearly interpolate between input values, select Edit, then Interpolate Selection (also, Ctrl+l). See “Edit Menu” for details.

This operation interpolates between the beginning and ending values in the selection. Because this will overwrite inputs, a confirmation is provided, as shown in Figure 8.16. Select OK to overwrite any inputs in between the two end values. Or if you want to preserve your sparse inputs, select Interpolate Between Inputs. One possible application of this is filling the gaps in series data. This functionality exists for both the slot and SCT dialogs.

Interpolate is available (enabled) if the following are true:

The Edit, then Adjust Values operation allows you to either add (or subtract) a fixed value to the selection or scale the values by a percentage. This can be applied to any arbitrary slot / timestep cell selection in the SCT. Both absolute and relative (percentage) adjustments of values in series slots can be made. Absolute adjustments are available only when all cells in the selection have the same scale and unit. Neither NaN values nor Read-Only (cross-hatched) values are affected. Since slots can appear in an SCT more than once, the adjust value operation is careful to adjust each selected Slot/Timestep value only once. Select the Report Results checkbox to see a summary of the slots changed.

You can clear all editable values by selecting them and pressing the Delete key. Or select Edit, then Clear Values.

When a value is cleared:

Also, to clear values, select Edit, then Clear Outputs, then within Selection, then whole SCT.

Clear Outputs clears values that would generally be computed during a model run. This includes clearing values that have the following flags:

Flags are properties associated with individual slot timesteps that are generally depicted in the SCT using background color shading.

You can set the Input (I) and Output (O) flags on editable slot timesteps; input flag can be set only on timesteps with a defined (non-NaN) value. Other flags can be set only on certain slots. The Target Operation sometimes involves coordinating pairs of internal flags on different timesteps. See “Set a Target Operation” for details.

Flag operations are available in the Edit menu and as toolbar buttons that can be optionally shown or hidden depending on settings in the Configuration Dialog Flags tab. See “Edit Menu” and “Flags Tab” for details.

These operations are also available as keyboard accelerators, as follows:

If the current cell selection includes any slot that doesn’t support a particular flag, the Flag Set operation for that flag is disabled. The disabled menu operations are indicated as grayed-out. The active Flag Set toolbar buttons are indicated with a black border.

You can apply a Target Operation to a single timestep or to a contiguous range of timesteps on the following slots:

If the Target Operation is applied to a single timestep, by setting the Target Flag on a single selected timestep, then that timestep is regarded as the final timestep of the Target Operation. The first timestep is implied by the flag values in the preceding timesteps. This implicit Target Begin timestep is determined during the model run. See “Set a Flag” for details.

If the Target Operation is applied to a range of timesteps within a slot then the earliest timestep is assigned the Target Begin Flag and the latest timestep is assigned the Target Flag. In this sort of Target Operation, the final target timestep is indicated with a solid background fill color of the user-configured Target color (see “Flags Tab” for details), and the previous timesteps have only a thick border of that color.

Target Operations are indicated by a frame around all of the timestep cells within the target range.

Through the following four steps, you can copy a single timestep value to one or more timestep values on a slot having the same unit type. This works both within a single SCT or between SCTs. You can repeat, any number of times, the third and fourth steps detailed below.

You can copy a set of timesteps within a single slot to another time within the same slot or to a different slot having the same unit type. This works both within a single SCT or between SCTs.

Within a single SCT, you can copy a set of contiguous timesteps across all slots to other timesteps. You can repeat, any number of times, the third and fourth steps (pasting) detailed below.

You can copy the series data of a whole slot to another slot in the same SCT or to a different SCT. You can repeat, any number of times, the third and fourth steps (pasting) detailed below.

All but the Paste as Input and Ctrl+N operations perform the default paste operation that pastes only input semantics values and flags—and clears all the other destination timesteps. See “Copy and Paste” for details.

It is possible to copy to the system clipboard the numeric values displayed in an SCT and, to then paste those values into another application like Microsoft Excel.

Data is copied with the displayed units and without reference to units (but, optionally, with greater precision).

Use the following steps to copy data to the system clipboard.

Use the following steps to paste data from the system clipboard.

You can print a depiction of all or part of an SCT. From the SCT, only the Row Header Table and SCT Data Table (with column headers) are included. The printed-page header and footer contains some information about the SCT and RiverWare model.

There are three File, then Print menu operations:

The Print, then Selection operation prints the minimum enclosing rectangle around the selection. In the aggregated views, summary rows are included only if all of their subordinate detail rows are included. The selection ornamentation (reverse colors) prints only through the Print, then Page and Print, then Full SCT operations.

When you select the plot operation, the full range of the selected slots is plotted in a Plot Page. Plotting is enabled only if no more than two unit types are represented within the selection.

You can display a plot of the selected slots either by one of the following:

The SCT does not support directly exporting data to files. However, see “Copy/Paste Data to/from the Clipboard (e.g., to Excel).” for instructions on copying selected information.

Data can also be exported to text files from the individual slots. Select Slots, then Open Slots to open the slot. Then use the File, then Export menu to export the data. See “Slots Menu”.