Large models can rarely be viewed in their entirety on the workspace, making it difficult to locate objects. There are, however, multiple ways of navigating through a model on the workspace or locating particular objects within a model. These methods are described in greater detail below.

The zoom features can be accessed by selecting the Zoom buttons on the toolbar    or by right-clicking the workspace.

At 100% zoom level, object icons are shown in their natural size of 40x40 pixels. When zooming out, e.g. to 50%, to expose a broader area of the workspace, the object icons and labels are also zoomed out and their size is reduced. When zooming in beyond the 100%, icons, labels and links remain their natural size (100%) instead of becoming larger (or thicker links). This allows you to expose more detail of background images around closely clustered objects without showing large icons. This implementation of smart zooming affects only the Simulation and Geospatial views.

On the Simulation, Accounting, and Web Map views, an overview of a model can be accessed with the locator window. The locator window displays the entire workspace on a miniature scale. The locator window is accessed as follows:

The rectangle represents the current displayed portion of the workspace. Dragging the rectangle to different regions of the model in the locator will cause that region to be displayed on the workspace.

A status bar shows the name of the Simulation Object near the cursor. This functions even while dragging the inscribed rectangle.

The Locator Window has a Context Menu (right-click) with the following options:

The In-view Locator Mode is an alternative to the separate Locator Window. It is also only available on the Simulation, Accounting, and Web Map views; it is not available on the Geospatial view.

Selecting this mode causes the workspace to temporarily rescale to show the scope of all of the simulation objects on the workspace. The rectangular region of the normally visible area (at the currently set zoom level) is shown as a shaded rectangle. Drag the shaded rectangle to a new area and upon releasing the button, the workspace is positioned at the new area at the previous zoom level. This allows you to quickly snap to a different area in your model.

If a model is not particularly large or is familiar, it is possible to move to the desired region of the model using the scroll bars. By default, the scroll bars are located in the lower corners of the workspace. Adjusting the scroll bars will pan the model to the desired location. Also, you can use the middle button to temporarily enter Pan Mode to pan through the workspace.

The dockable object list window provides a convenient means of locating a specific object within a model. The object list window can be detached from the workspace and be positioned at a desired location. If you undock and/or close the object list, you can show it using the Windows, then Show Simulation Object List menu. Selecting the desired object in the listview window automatically selects the object on the workspace. Right-clicking an object allows you to open the object without scrolling the workspace.

At the top of the Simulation Object List, enter text into the text box to filter the object list.

Objects are shown or hidden in the list as you type. For the object to be shown, the object name must contain the specified text. Case is not considered. The header for the list indicates how many results are found, for example, “3 of 15 shown”. Use the button on the right to clear the filter.

Objects in the list window can be organized by Name, Type, Position or a Custom Order. Objects are further organized in ascending or descending order by selecting the column label.

 

The Custom Order is defined using the Edit Custom Order menu. The Edit Custom Object Order dialog is shown:

To use the Edit Custom Object Order dialog box, select an initial order using the Name, Type, or Position buttons. Then select one or more objects by selecting an object and then using Shift or Ctrl key and selecting another object. Drag and drop or use the up and down arrow buttons to rearrange. When you click OK, this order is preserved as the custom order and is shown on the Object List.

You can configure the workspace appearance when the model is first opened in terms of the view, zoom, and scroll location. On the workspace, use the Workspace, then Initial Appearance menu. The Initial Workspace Appearance dialog opens.

First, choose one of the following:

Then, for each of the three workspace views, Simulation, Accounting (when enabled), and Geospatial, specify the zoom level and scroll location to use. Each view maintains these setting separately. For the location, select between one of the following methods to specify where to scroll:

The DateTime can be specified explicitly or symbolically as RPL DATETIMES; see DATETIME in RiverWare Policy Language (RPL) for details. Text below the editor field indicates the actual DateTime of the entered symbolic time text (if it is valid), or the status if it is not valid. You can also use the menu to specify one of the common DateTimes. Some of these are expressions which must be edited to become valid, e.g. by replacing “N” with a nonnegative integer and the HH:00 MMM DD, YYYY formula, where you substitute the hour, month, day and year.

The Datetime Editor option opens a separate dialog to specify the DateTime using a selector configured for the model's timestep size.

The Global RPL Function option opens a Function Selector to select a RPL function in the Expression Slot or Global Function Set.

Select Help (question mark icon button) on the right side of the symbolic DateTime editor to show a description of symbolic DateTime representations.

The Workspace has two cursor selection modes. These define the effect of clicking and dragging on the workspace.

Selection Mode is used for selecting and repositioning Simulation Object icons on the workspace.

Multiple icons can be selected by dragging a rectangle over the icons (with the drag operation started off any icon). Selecting an icon while holding down the Control key toggles the icon in or out of the selected set.

A set of selected icons can be moved together by starting the icon drag on one of the selected icons. An icon move operation can be aborted by hitting the Esc (escape) key before releasing the button.

Pan Mode allows the user to move or pan the workspace canvas within the visible workspace area.

Use the middle mouse button to temporary enter Pan Mode from Selection Mode.

All opened windows can be closed at once using the Close Windows feature. When this button is clicked, the Close Windows confirmation opens. Select the types of windows that should be closed (all are selected by default) including the following:

Then the Close Windows button closes the selected types. This utility never closes the Workspace. In addition, the following types of windows are minimized instead of being closed:

As the text in the dialog shows, you can also Shift-Click the button and it will close all the windows without first seeing the Close Windows confirmation.