The workspace features a main menu bar in which the various functions of RiverWare are organized into menus. The workspace also contains a dockable toolbar featuring shortcut buttons to some key RiverWare operations and utilities. There is also a dockable object listview window of all the objects on the workspace. A screenshot of the workspace is shown in Figure 1.1.

 

The workspace supports two modes

Typically, Full mode is used when building a model or investigating objects on the workspace. Compact mode is used when you don’t need to see the canvas views and you want to use the toolbar buttons and menus to run a script, execute a run or look at outputs. In this approach, some users will open RiverWare, detach the Object List and then switch to Compact mode to provide a more efficient use of screen space.

To switch between the two modes:

The following sections describe each mode.

When the canvas is shown if Full mode, the canvas views are shown along with the menus, toolbar, dockable windows, and status bar. This is the default and primary view of the simulation space where models are built and modified. In the workspace, a model is graphically represented as a network of objects with links connecting the objects. The workspace allows for exploration of the model through the following viewing options:

Figure 1.3 shows a view of the workspace in Full mode.

“Compact” display mode shows only the title bar, menus, toolbar (if enabled), and status bar. In other words, the Compact display mode hides the canvas/views, Simulation Object List (if shown and docked within the workspace), and Animation controls (if shown and docked within the workspace). Figure 1.4 shows a view of the workspace in Compact mode.

You can select the icon that is shown at the left of the title bar on all windows associated with the RiverWare session. The ability to control the color of the RiverWare icon is particularly useful when you are comparing two models in two separate sessions of RiverWare. There are two ways to change the icon:

Then all windows and the task bar will use the selected icon. The selected icon color is saved in the model file.

Figure 1.5, Figure 1.6 and show the available icons.

Sometimes the workspace can obscure other dialogs that you may wish to see. When this happens, you can use the Send Workspace to Back operation to force the Workspace window to be displayed behind any other overlapping window. The action is available in the following ways:

Since the Workspace is the main RiverWare interface and the hub for many actions and operations, it is often necessary to open the workspace to access other parts of the RiverWare. To show the workspace from many other dialog boxes in RiverWare, use the Show Workspace operation using one of the following:

The font, size and style used for menus, lists and other text can be changed from the Utilities, then Windows, then Set Font menu. Following are limitations with this feature:

The toolbar in RiverWare is dockable, meaning it can be moved from one side of the workspace to the other or exist as an independent dialog. Table 1.1 summarizes the Workspace buttons.

There are three “Viewer” buttons at the bottom of the workspace. The buttons allows for quick access to the appropriate viewer showing previously opened viewer dialogs. The buttons are disabled if there are no items shown in the viewer. The viewer buttons are:

Also shown are color-coded icons for the following:

Hover over any icon for a tooltip indicating the location or click to open that set. Also, the sets are still available through the Policy menu. See About RPL Sets in RiverWare Policy Language (RPL) for the color code for sets.

The Simulation Workspace right-click context menu (when not selecting a simulation object icon) has the following options.

The moving of Simulation Object icons on the Workspace can be disabled by locking icon positions as follows:

RiverWare provides the option to show commas as a thousands separator in slot values (slot dialogs, SCT, accounts, and exchanges) and numeric values entered into a RPL expressions. Commas are shown by default but can be turned off by selecting the Workspace, then Show Commas in Numbers option. When the option is selected, all values will update automatically.

Often users find that they may wish to annotate their workspace with text or image files. To do so, use the right-click context menu and select Add Text or Add Image. This opens a dialog where you can specify the text or an image, respectively. The image on the left shows the text editor and the resulting text below it. Figure 1.9 shows the image editor with a small image shown. Also shown is the tooltip for the specified text. This is the text you see when you hover over the image.

These are supported separately on the Simulation and Accounting views, but not the Geospatial view.

Images are saved in the model file and will increase the model file size. GIF, PNG, or JPG images are supported.

The Output Canvas allows you to create spatially distributed output visualization diagrams. You can show the following items from an Output Canvas directly on the Simulation and/or Geospatial Views. See Showing Canvas Items on the Workspace in Output Utilities and Data Visualization for details.

When items are shown on workspace views, an additional panel of Animation Controls is shown below the Simulation Object List, as shown in Figure 1.10. See Animation in Output Utilities and Data Visualization for details on the controls.

Like other dockable windows, this panel can be pulled off the workspace to its own dialog, docked on the left side of the workspace or closed. To redisplay the panel, use the Utilities, then Windows, then Show Animation Controls menu.

The Slot Cache provides a temporary copy of series slot values. The cache is created from the Workspace, then Create Slot Cache menu. Within the run range, all visible series slots (except those on Data Objects that are not optimization variables, exchanges, supplies, and those slots with different step size than the run) are copied to the cache when this menu is operated. These values can be accessed using RPL predefined functions SlotCacheValue and SlotCacheValueByCol. They are typically used during an optimization run for certain Seed Method parameters. The cache values are not saved in the model file.

Manually clear the Slot Cache using the Workspace, then Clear Slot Cache option.

All objects can be cleared from the workspace by selecting Workspace, then Clear Workspace. A confirmation dialog appears warning that all objects on workspace will be removed. All rulesets will also be cleared and any unsaved changes will be lost.