Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: figure 16 still needed
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

Note: 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.

...

 

Info
iconfalse

Note: 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 convenient 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

...

Anchor
Schematic Editor options toolbar
Schematic Editor options toolbar
Schematic Editor options toolbar (refer to Figure 14)

  • 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 left and centre schematics of Figure 15 show the difference between how a model will be represented after you press this buttonthe bottom. 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 centre of Figure 13 Figure 15 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 The schematic on the right of Figure 15 shows the behaviour of the Schematic Editor with the Link Labels control turned on.
  • 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 Figure 15 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.

  • Show/hide water user and bulk licensing links - controls the view of links between the following types of nodes:
    • Supply point and water user nodes; and
    • Bulk licensing and gauge nodes.
Info
iconfalse

Note: 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.

 

Figure 14. Schematic editor options toolbar, options

Image Added

Figure 15. Schematic editor options toolbar, options

Image Added

Schematic Editor grid toolbar (refer to Figure 1416)

  • Toggle display of the grid using Display Grid Snap to Grid. The default state is off but the setting is saved with your project. Figure 1317 compares the appearance of the Schematic Editor with the Display Grid Snap to Grid control turned off (centreleft) versus on (grid sizes 10 and 5050px centre and 100px right). Turning this setting on does not affect the alignment of existing nodes. Alignment with the grid is only enforced when you drag a node. The default state is off but the setting is saved with your project. The grid does not need to be visible for alignment to occur.
  • Change the frequency of grid lines using Set Grid Size. The default is 10 pixels but the setting is saved with your project. Figure 1317 shows the appearance of the Schematic Editor with a grid setting of 10 pixels (leftcentre) and 50 pixels (right). This is synonymous to right clicking on the Schematic Editor and choosing Grid Settings...
  • You can view a sample printed copy of the model displayed in the Schematic Editor using Print (Schematic Editor grid toolbar). At present, the entire schematic is scaled to fit within a single A4 page in portrait mode. An example is shown in Figure 1518.
  • You can save a Source model in .JPEG format using Save as Image (in the Schematic Editor grid toolbar).This command opens a standard file dialog box so that you can choose where to save the image. At present, the entire schematic is scaled to fit within a single A4 page in portrait mode.

 

Figure

...

16. Schematic editor grid toolbar,

...

Image Removed

...

options
Figure 17. Snap to grid on/off comparison 

Image Added

Figure 18. Schematic editor, Print preview

Tabular Editor

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

...

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.

...

  • 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 1619) 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 the Function 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 conditional format, and the expression name is displayed. Click Remove to delete an expression from the list.

Figure

...

19. 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

...

20. Tabular editor, Formatting, column settings

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

Figure

...

21. Tabular editor, Formatting, header settings

 Project Explorer

The Project Explorer (Figure 1922) 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.

Figure
19
22. Project Explorer

Project Hierarchy

The Project Hierarchy (refer to Figure 1924) displays a structural breakdown of the project. The type of display will depend on the view selected within the View Type pop-up menu on the Project Explorer toolbar. All view options will display at least the project and scenarios within the project. The Default View, which is shown on the left side in Figure 2023, displays individual elements that make up a model. The Parameter View (right side in Figure 2023) displays all the recordable parameters for the model.

Figure

...

23. View type menu options

Model parameters

The Model Parameters area (refer Figure 2023) shows which parameters will be recorded for the scenario element (node, link, catchment etc) that is currently highlighted in the Project Hierarchy. The indicators have the following meanings:

...

Layer Manager

The Layer Manager (Figure 2124) is mainly associated with the Geographic Editor. It is visible by default when you create a new catchments scenario. Choose View » Layer Manager if the Layer Manager is not visible. You can add new layers, and move layers up and down in order of visibility. The checkbox next to a layer’s name indicates that the layer is visible in the Geographic Editor. Note that any layers that are added or removed are not persisted in the scenario.

Figure

...

24. Layer manager

Recording Manager

The Recording Manager displays a list of all the recorded results from the model run or runs. Each model run has its own tab. You can sort the results by clicking the column headings. The associated with this window gives quick access to common functions.

...

The default position of dockable windows is docked. A single click within the borders of any docked window will activate it. An active window can be identified from either its title bar or from an element within it that is highlighted. For example, the Project Explorer is the active docked window in Figure 2225.

Figure
22
25. Identifying active windows

You can undock a window by dragging its title bar to a new location (eg. Figure 2326). This can be into another docked position within the main window, or to a position outside the main window. The predicted position of a window is indicated by a transparent outline. When you release the mouse button, the window will be placed in that position. You can also double-click a docked window’s title bar to undock it. The remaining windows will reposition to take up any vacant space within the main window.

Figure
23
26. Window undocking (highlight)

Undocking plugin windows

The windows of some plugin tools (eg.GWLag) may be docked in the main window. However, once a plugin window has become docked, the window has no title bar which can be dragged or double-clicked to cause it to become undocked. You can undock such a window by:

...

You can dock an undocked window within the main Source window by dragging it back into the main window. Source highlights potential target locations with transparent outlines (Figure 2427). Choose the desired position and release the mouse. You can also re-dock an undocked window by double-clicking its title bar. The window will become docked in the main window, usually in the position it occupied before it was last undocked. The other docked windows will resize to accommodate the incoming window.

Figure

...

27. Window docking

Auto-hiding dockable windows

Many of the dockable windows can be hidden temporarily to allow for improved use of screen space. To activate the auto-hide function, click the icon at the top right hand corner of the window you want to auto-hide. The icon turns 90° to indicate that the window is in auto-hide mode and the window reduces to a tab at the side of the main window (Figure 2528). You can inspect a hidden window by hovering the mouse pointer over its tab. The hidden window will slide open and will remain open while the mouse pointer remains within its borders. When you move the mouse pointer beyond the window’s confines, it will slide closed. If you click anywhere inside a hidden window, it will remain open until you click beyond the window’s confines.

Figure
25
28. Window auto-hiding (tab display)

Adjusting window sizes

The overall size of the main window can be adjusted using a combination of the full-screen toggle (Maximize) and Minimize controls, the window Resize control, and/or by dragging the four edges of the window. Within the main window, the amount of space taken by each docked window can be adjusted by dragging the split window controls. All of these controls are shown in Figure 2629. The controls to drag internal and external window boundaries only become available when the mouse cursor is placed over the critical regions. Once the cursor changes to an edge-dragging control, click and hold the mouse cursor, then drag the cursor in the appropriate direction to adjust the window edge.

Figure
26
29. Window size adjustment controls

About feature editors

A feature editor window allows you to define various parameters for nodes and links. It opens when you double click on components in the Schematic Editor. You can also open a feature editor by right-clicking on the node or link and choosing Edit from the contextual menu.

Each node or link type supports different parameters, so the exact structure of feature editors varies according to the type of node or link being manipulated. However, the controls shown in Figure 2730 are common to many feature editors.

The left panel lists all parameters associated with the node or link. You can also add a note to a node or link to indicate a specific feature for example, which may affect its behaviour during a scenario run. This note is indicated as an exclamation mark on the component's icon in the Schematic Editor. It also appears in the Recording Manager after a scenario run. Too include a note, right click on the component's icon in the feature editor and choose Add Note. This is shown in Figure 2831.

Contextual menus can be accessed by right-clicking on various elements in the user interface. In some cases, choices in contextual menus duplicate those in toolbars and the main menu structure. In others, the contextual menus are the only way to access a particular function. All contextual menus available in Source are shown with the relevant feature editor or graphic;

Figure

...

30. Feature editor (common controls)

Additionally, many text fields support a contextual menu. You can use that menu to copy and paste text and include Unicode characters (see Figure 2831).
Figure
28
31. Text field contextual menu

Other behaviour which is shared by a number of feature editors includes:

...

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 Figure 33 shows the relationship between the various components.

Figure
29
33. Date-picker

You can edit a date directly by selecting either the Day, Month or Year element within the text field (you cannot select the day of the week). Once an element has been selected, you can also change the selection by using the left and right arrow keys. You can adjust an element’s value by using the up and down arrow keys or by entering a new numeric value. Note that you also use numeric values for the Month element. For example, typing "7" changes the Month element to "July".

...