Note: This is documentation for version 5.12 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above

Geographic Editor

The Geographic Editor shows a geographic representation of the catchment model, and displays the sub-catchment map and the node-link network of the current scenario.

Figure 1. Geographic Editor contextual menu

 

Several commands are available when you right-click in the Geographic Editor (Figure 1):

  • Pan allows you to click the geographic representation of the model and move it up or down, left or right;
  • Zoom In allows you to left-click and drag the mouse to define an area to zoom into. Undo Zoom allows you to undo this action. To zoom all the way out, double-click the geographic view anywhere outside a sub-catchment; These zoom actions are synonymous to using the zoom icons in the Geographic Editor toolbar.
  • Select allows you to select a node, link, sub-catchment, etc on the map by clicking it;
  • Draggable allows you to drag the map and drop it onto another map, to overlay the two maps;
  • Add node allows you to add a node to the model;
  • Add Link allows you to add a link to the model;
  • Activate selected component(s) if it has previously been deactivated
  • Deactivate selected component(s), see link for details. 
  • Multi-activate activates the selected component and either all upstream component or all downstream components (including all components in tributaries), based on your choice from the sub-menu.
  • Multi-deactivate deactivates the selected component and either all upstream components or all downstream components (including all components in tributaries), based on your choice from the sub-menu.
  • Multi-select can select all upstream components, or all downstream components,  or all downstream components (including all components in tributaries) from your base component currently selected.

  • Combine catchments can merge sub-catchments and reset relevant model elements (such as network/link) and attributes (such as rainfall runoff model parameters) in an existing catchment model ( see details).

  • Add opens a sub-menu listing all nodes. Select a node from the list and it will be added at the place you clicked. This option is synonymous to dragging a node from the node palette on to the schematic. It is only visible in the contextual menu if you right click on a blank area in the Schematic Editor, rather than on a component. 
  • Copy the selected component(s)
  • Delete removes the selected component(s) from the scenario
  • Edit opens the selected node's feature editor where you can edit its configuration;
  • Change node model by selecting the node, then choosing this option from the contextual menu. Use the sub-menu to choose the required node model;
  • Insert node model inserts a node in the middle of the selected link, splitting the link into two. Select the node type to insert, then select either Attach flow upstream or Attach flow downstreamThis determines whether the link immediately upstream or immediately downstream of the inserted node is attached to the sub-catchment and receives the sub-catchment's runoff.
  • Attach link provides a list of links that do not have a sub-catchment inflow. It is used to associate a sub-catchment with a link;
  • Change Link routing of a link by selecting in in the Geographic Editor, then choosing this option from the contextual menu. Choose the link routing type from the resulting sub-menu;
  • Apply Link to All applies the properties of the selected link to all other links in the catchment scenario;
  • Delete removes the selected node/link from the scenario;
  • Copy graph copies the current map (or graph) to the Windows clipboard;
  • Properties opens the properties window, which allows you to change the appearance of the map; and
  • Save... displays a list of the data represented on the map, and allows you to save that data in different formats. For example, you can save a node-link network in different node-link file formats, and a sub-catchment map as an ESRI shape file.

Geographic Editor toolbar (refer to Figure 2)

  • Print opens the Print preview dialog allowing you to save the geographic in the Geographic Editor as a pdf. The entire geographic is scaled to fit within a single A4 page in portrait mode. 
  • Save as Image saves the entire geographic in the Geographic Editor as a *.jpg. The entire geographic is scaled to fit within a single A4 page in portrait mode.
  • Track when enabled, the Geographic 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. The default state of this button is off. In this mode, Source leaves the Geographic Editor window unchanged, regardless of any selections you may make in the Project Hierarchy. 
  • Note/Error icons toggles the view of any notes and/or errors that are present in the Geographic Editor.
  • You can view the zoom and undertake various zoom actions using the zoom icons on the right side of the toolbar:
      • Current zoom displays the value of the zoom that is currently used in the Geographic Editor. This value has a range of of 1 – 1000000%;
      • Zoom in allows you to zoom into a particular part of the mode (or Ctrl and + on your keyboard's number pad or Ctrl and scroll up with your mouse scroll wheel). Similarly, Zoom out allows you to zoom out (or Ctrl and - on your keyboard's number pad or Ctrl and scroll down with your mouse scroll wheel). The range of Zoom out and Zoom in is also from 1%  to 1000000%. Both actions are performed in practical increments related to the current zoom valueand
      • Fit to window will display the entire model in the window.
  • Show/Hide Node/Link Display - controls the view of nodes and links:
    • Show link labels -  when selected, show link labels
    • Show node labels - when selected, show node labels
    • Custom display - when selected, show customized display of nodes and link labels
    • Configure custom display - by clicking this, a custom display configuration window will pop out,as shown in Figure 3. Ticking the little box to allow show Icon or show label for nodes and links
Figure 2. Geographic Editor toolbar

Figure 3. Custom Display Configuration


You can edit most Source networks within the Schematic Editor, but it is also possible to add and remove nodes and links from the Geographic Editor using the contextual menu, as follows:

  • To add a new node, right-click on the Geographic Editor and enable Add Nodes in the contextual menu. Then click on the Geographic Editor at the desired location of the new node (top right schematic in Figure 4). By default, all nodes are created as confluence nodes. Subsequent clicks in the Geographic Editor will place additional new nodes. Note that Add Nodes stays enabled until it is explicitly disabled by enabling a different mode (eg. Pan or Select) from the contextual menu . 
  • To change the node type, enable Select from the contextual menu. Click on the node of interest, which will highlight it. Right-click and choose Change Node Model. This will open another menu, which lists the node types you can change to. Select the desired node type (bottom left schematic in Figure 4). With Select enabled, you can also edit nodes and links through their respective feature editors.
  • Links can be added by enabling Add Link from the contextual menu. First, click on the upstream node (highlighted with an enlarged icon), then click on the downstream node; this will create a link. Refer to the bottom right schematic in Figure 4. Since Add Link remains enabled, subsequent pairs of clicks continue to add additional links until it is disabled. By default, a new link is configured with straight through routing. The routing type can be changed by right-clicking on the link and choosing Change Link Routing.
  • Nodes and links can be deleted after Select has been enabled from the contextual menu. Click on the node or link you wish to delete (this will highlight it) and press the delete key or right-click and select Delete from the contextual menu.


Spatial coordinates and elevations for nodes and reaches can be set using Location Control.


When deleting nodes and links, there is no warning given, and no confirmation is sought. When a node is deleted, all links immediately upstream or downstream of the node are deleted as well. This action cannot be undone

Figure 4. Geographic editor (Network editing)

Note: Sub-catchment runoff is fed into links, so deleting the receiving link, that is, the link associated with the sub-catchment, effectively stops that catchment runoff from entering the system. When this happens, the sub-catchment boundary is highlighted in red to indicate that it is disconnected from the network.

 To reconnect a disconnected sub-catchment to the network:

  • Create a new node (if necessary) and add a link to act as the receiving link for the sub-catchment;
  • Choose Select from the contextual menu and click the catchment you wish to reconnect;
  • Right-click and choose Attach Link (this will contain a sub-menu listing links that do not have a sub-catchment inflow); and
  • Select the desired link to attach the sub-catchment to the link.

Since version 4.2.0 of Source a visual distinction is made between the links which are connected to a sub-catchment and hence receive lateral flow, and those which are not. Lateral flow receiving links are shaded dark blue and links that are not receiving lateral flow are shaded light blue. This is illustrated in Figure 5.


Deactivating Nodes, Links and Sub-catchments

Deactivating a component in a catchment scenario allows water to pass through that component as if it were not there. That is, a deactivated component's downstream flow is always the same as its upstream flow, and constituents remain unaffected by the deactivated component.

 Performance Improvement

Deactivating large sections of a model (eg. a network branch) will improve performance by decreasing model run-time. This can be useful when you are working with part of a model only, eg. during calibration.

Nodes, links and sub-catchments can be deactivated two ways, either:

  • Select the component, right-click to open the contextual menu, select Deactivate; or
  • Right-click on a single component, choose Multi-deactivate to deactivate the selected component and either all upstream or all downstream components, based on your choice from the sub-menu.

Deactivated nodes are indicated by a grey circle backlash symbol on top of the node icon. Deactivated sub-catchments are indicated by a grey border.

Note that deactivating a sub-catchment is equivalent to deactivating its receiving link, and vice versa. Therefore, a deactivated link in a catchment scenario is shown by the associated sub-catchment having a grey border in Geographic Editor, while in Schematic Editor, the deactivated link will show as a solid grey line. It is possible to have links in a catchment scenario that are not receiving runoff from a sub-catchment. For example, if you have inserted a node using Insert Node Model, only one of the two links is a recieving link. If you deactivate a non-receiving link, it will be shown as a solid grey line in the Schematic Editor, but its deactivation is not indicated in the Geographic Editor. 

Figure 6 shows an example of component deactivation in a catchment scenario, with an inserted gauge that has a downstream receiving link. The scenario is shown in Geographic Editor (top row) and Schematic Editor (bottom row) when the Gauge node alone was deactivated using Deactivate (left pane), or the Gauge and all upstream components were deactivated using Multi-deactivate » This and all upstream, or the gauge and all downstream components were deactivated using Multi-deactivate » This and all downstream including tributaries (right pane).

 For more information about component deactivation, see Schematic Editor - Deactivating Nodes and Links.

Figure 6. Node, link and sub-catchment deactivation in a catchment scenario

Deleting Sub-catchments

Individual Sub-catchments can be selected and deleted from the project (Figure 7). To delete a Sub-catchment, select the sub-catchment and then right click to bring up the menu. Select delete and the selected sub-catchment will be deleted. Multiple items can be selected in the one operation, and if 10 or more items are selected a warning will be displayed before the deletion is completed. Care needs to be taken when doing this because once an item is deleted all underlying configuration for that item is lost from the model.

Figure 7. Deleting a Sub-catchment