Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Figure 1. User interface for Source 

...

The Data Sources toolbar allows you to add and manage sources of data (time series or by linking to another scenario). You can edit or view this data once it has been loaded in the Data Sources Explorer.

File toolbar

The File toolbar contains commands for creating a new project, opening an existing project, and saving a project (and all the scenarios within that project).

...

To create an Operations scenario, first create a River Manager scenario. Then, choose Tools » River Operations to open the River Operations dialog.

Opening a scenario

When a project only contains one scenario, that scenario is opened automatically when you open the project. However, when a project contains more than one scenario, you must open each scenario individually.

...

 

Info
iconfalse

You cannot use an earlier version of Source to open a project that was saved by a later version.

Copying a scenario

You can duplicate existing scenarios. You may want to do this if you wish to experiment with variations without affecting your original scenario.

...

 

Note

If you save a project in the folder where Source is installed, the project may be removed during any un-install procedure. 

Editors

Source uses editors which are tailored to the needs of the main scenario types. There are three main editors, known as the Geographic, Schematic and Tabular editors, which support the catchments, management and operations scenario types respectively. These editor-scenario type associations are not absolute and you will often use multiple editors within a given project. For example, you can use the Schematic Editor to define the model of a river system for both operations and management scenario types. The next section provides an overview of each of them.

...

Figure 11. Geographic editor (Network editing)

 

 

Info
iconfalse

Catchment runoff is fed into links, so deleting a link that is associated with a catchment effectively stops that catchment runoff from entering the system. When this happens, the catchment boundary is highlighted to indicate that the catchment is disconnected from the network. Follow the steps listed to reconnect the catchment to the network.

You can also set geolocation coordinates and elevations for nodes and reaches using the Location Control window (using View » Location Control, as shown in figure 12). While it is not essential, it is conventional to set elevations with respect to Australian Height Datum (AHD). You can enter negative numbers for components that are below sea level, such as the lower lakes of the Murray. The elevation of a component is the zero point for that component. For example, the zero point for a storage is the lowest point in the storage.

Figure 12. Location control

Image Modified

Anchor
Customising views in Schematic Editor
Customising views in Schematic Editor
Customising views in Schematic Editor

...

  • You can work with links and nodes in the Schematic Editor using Allow Link Dragged. This button allows you to disconnect the downstream end of a link from the node to which it is attached, and then reconnect that link to the upstream inlet of another node. You can use this feature to insert new nodes into a schematic without losing the configuration of existing links.
  • Straight Lines controls the representation of links. Source defaults to drawing links using orthogonal (elbow) lines. Click this button to change the default representation to straight lines. The top-left schematic in Figure 13 shows how a model will be represented after you press this button. The representation of any link can be controlled independently using the contextual menu in the Schematic Editor. Right-click the link and choose one of the options in the Link Type sub-menu. Each line has one control point which you can adjust to route the line around obstacles. The control point for an orthogonal line can only be moved in the vertical dimension whereas the control point for a straight line has no restrictions on its movement.
  • Node Labels controls whether the names of nodes are shown in the Schematic Editor. Source defaults to displaying node names. The schematic on the right of Figure 13 shows the behaviour of the Schematic Editor with the Node Labels control turned on.
  • Link Labels controls whether the names of links are shown in the Schematic Editor. Source defaults to displaying link names.
  • Track (Schematic Editor options toolbar) controls whether the Schematic Editor always scrolls to show components as they are selected in the Project Hierarchy. The default state of this button is off. In this mode, Source leaves the Schematic Editor window unchanged, regardless of any selections you may make in the Project Hierarchy. If you turn Track on, the Schematic Editor window will scroll to bring into view any node or link that you select in the Project Hierarchy. You can use this feature to locate components in large models.
  • Overview Panel controls whether the Overview Panel is shown in the Schematic Editor. The default state of this control is off. The schematic on the bottom left of Figure 13 shows the behaviour of the Schematic Editor with the Overview Panel control turned on. You can use this button to obtain a thumbnail view of your entire schematic. You can drag the Overview Panel to any point within the Schematic Editor but you cannot pan the Schematic Editor by dragging within the Overview Panel.
  • Pan - controls movement of the drawing surface. When this button is enabled, clicking and holding on any part of the drawing surface in the Schematic Editor moves the entire drawing surface. This is an alternative to using the scroll bars;
  • Tool tips - controls the view of tool tips containing information about a node’s order in the flow sequence, its elevation and the node type. A storage node contains additional information including its height, capacity and surface area:
    • Tool tips on – when selected, clicking on any node in the Schematic Editor causes a small floating window to appear which contains additional information about that node;

    • Tool tips offwhen selected, the floating windows do not appear; and

    • Tool tips locked – when selected, clicking any node in the Schematic Editor causes a small floating window to appear next to every node.

Info
iconfalse

At present, only the setting of the Straight Lines button is saved with your project. Any changes you make to individual links or control points are lost when you close your project.

Schematic Editor grid toolbar (refer to Figure 14)

...

Tabular Editor

The Tabular Editor provides a spreadsheet-like representation of data that is otherwise presented in graphical form in the Recording Manager.

Customising the Tabular Editor

You can customise the Tabular Editor to your needs. For each type of node or link, you can select:  

  • A background colour for the cell;  
  • A foreground colour and stylistic variation (eg. bold-face) for values displayed in the cell; and  
  • The number of decimal places to be displayed.

 

There are two ways to apply formatting: 

 

  • By adjusting a set of user preferences. See Tabular Editor Formatting. Changes made via this method apply to all projects; or
  • By right-clicking a column heading and choosing Column Formatting (refer to Column formatting). Changes made via this method only apply to the current project.  

Column formatting

In this window, the Multiple Expressions tab (as shown in Figure 16) allows you to apply conditional formatting to cells in the tabular editor to highlight when thresholds or rules are breached eg. Flow < 500 ML/day. More than one expression can be applied to a cell. Click Add to specify the details of an expression, and Edit to define the expression using an Expression Editor. When more than one condition is satisfied, the cell is formatted as per the left side of the panel. Hover the mouse over the cell with the conditonal format, and the expression name is displayed. Click Remove to delete an expression from the list.

Figure 16. Tabular editor, Formatting, multiple expressions

...

The Column Settings tab allows you to override project-related Tabular Editor Format Settings for the parameters displayed in the Tabular Editor.

Figure 17. Tabular editor, Formatting, column settings

The Header Settings tab allows you to create a header title (label) and header colour for the Tabular Editor.

Figure 18. Tabular editor, Formatting, header settings

 Project Explorer

The Project Explorer (Figure 19) allows you to manage model components using a combination of the menu bar, the Project Hierarchy, the Model Parameters area, and pop-up menus. For an active scenario, clicking an item in the Schematic or Geographic Editor highlights it in the Project Hierarchy.

...

  • You should always include an explicit origin of (0,0). This avoids the need for the model to extrapolate in the negative direction along the X-axis. It also avoids any potential problems which might arise if the model silently assumes an origin of (0,0);
  • X-values should always be in monotonically increasing order. In the current implementation, an X-value that is entered out of order is highlighted in red until a Y-value is entered, after which Source re-orders the table. You can use this feature to add interstitial coordinates to a table by adding new (X,Y) coordinates to the last row and waiting for the table to re-order;
  • Y-values should also increase monotonically. Be cautious if you need to violate this guideline, and especially cautious if the right-most line segment has a negative slope;
  • The right-most coordinate pair should lie beyond your most extreme known value. This avoids the need for the model to extrapolate in the positive direction along the X-axis, and also means that you do not need to remember which piecewise linear editors use linear extrapolation of the right-most line segment vs those which project the right-most Y-value to infinity;
  • All values should be sensible. For example, there is no point in entering coordinate-pairs that violate mass balance (eg. a loss exceeding inflows); and
  • If your model employs optimised ordering, keep your piecewise linear editors to as few data-points as possible. Complex curves usually increase run-time and can sometimes lead to infeasible solutions. Refer to the chapter on Ordering.

Working with date-pickers

Date-pickers are used in a number of places within Source. They are a combination of an editable text field and a pop-up calendar. Figure 29 shows the relationship between the various components.

...