Note: This is documentation for version 4.3 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above
Nodes and Links
- Anonymous
- Teamcity
- Geoff Davis
About Nodes
Nodes represent places where actions or measurements occur in a river system, where water can be added, extracted, stored, recorded, or change ownership in a model. A node can be used to represent things that actually happen over a large physical area but that, for modelling purposes, occur at a single point. In sub-catchments, they provide a position in the catchment network where water management information can be placed. In Source, nodes are depicted using the icons shown in Figure 1.
Figure 1. Source node icons
Using nodes in Source
This section outlines how to work with nodes in Source. Some actions can be duplicated for links.
Adding nodes in a model
To add a node to a model, either:
- Drag the appropriate type of node from the Node Palette and drop it onto the Schematic Editor; or
- Right-click on the Schematic Editor and choose the appropriate node from the Add menu.
About Links
Links connect nodes in Source - they link, store and route water passing between nodes. Nodes are connected using links only, and two links cannot be connected to each other without an intervening node.
A reach refers to a stretch of river, or physical section, between an upstream and downstream location. A link, on the other hand, is a logical connection within a river systems model. Routing describes the change in timing and shape of flow as water moves down a river.
Links (or reaches) can have routing configured on them. For links (or reaches) that do not have routing configured, they are used to define the order of execution in the model.
Links are categorised as either:
- Vertical - used to connect most nodes. The first four types of links in Table 1 are all vertical; or
- Horizontal (or wetland links) - used to connect the Wetlands Hydraulic Connector node (source) and the Storage node (target) only. The presence of a horizontal link at a storage node indicates that the storage is behaving as a wetland. Figure 2 shows an example of a horizontal link.
The Node Connection Matrix shows the types of links created when you connect different nodes.
Table 1. Link types in Source
| Type of link | Used to connect | Representation in Schematic Editor | Example |
|---|---|---|---|
| Demand link | Supply point (source) and water user (target) nodes only | Red, dashed line |
|
| Lagged flow routing | Various nodes | Black line, with alternating dots and dashes |
|
| Storage routing | Various nodes | Black, solid line |
|
| Straight through routing | Various nodes | Black, dashed line |
|
| Wetland link (Horizontal) | Wetlands Hydraulic Connector node (source) and the Storage node (target) only | Green, solid line | Shown in Figure 2 |
Using links in Source
Once links have been added a model, you can edit several attributes in a similar fashion as for nodes:
- Node and link default names;
- Renaming nodes and links;
- Configuring node and link parameters;
- Adding notes to nodes and links (only for lagged flow routing and storage routing links);
- Searching for nodes and links;
- Deleting nodes and links;
- Node and link default names; and
- Copying and pasting.
Adding links to a model
To add a link to a model, first refer to Figure 1 which defines the terminology. To create the link:
- Position the mouse cursor over the upstream node;
- Click and hold on one of its downstream connectors and start dragging;
- When you start dragging the mouse cursor, candidate targets are displayed (as large icons) for the upstream connector of a downstream node; and
- Release the mouse and the link will ‘snap’ into place.
Figure 1. Node connection terminology
For horizontal links, the node connectors appear on the left and right side, instead of above and below the nodes. Click and drag these connectors together as described above. You can also drag the link vertically once it has been created by clicking on the red dot. This appears in the centre of the link when you click on the link.
Figure 2. Horizontal link
Dragging links
You can disconnect and reconnect a link between nodes rather than having to delete and re-add it using the Allow Link Dragged button in the Schematic Editor options toolbar. Note that not all links can be connected to all types of nodes, and specific nodes require certain links. Refer to Types of link routing for more detail.
Link elevation
You can set the elevation for a link using the Location Control window.
Working with Nodes and Links
Node and link default names
Whenever a node or link is created, it is given a default name in the pattern:
type #
where "type" is the type of node or link and "#" is a number which increases monotonically during the life of the schematic.
Node connections
Nodes can be joined to each other, links between nodes will vary depending on the nodes being connected. For example, a wetland conveyance link will occur when a storage node is linked to a wetland connector.
Renaming nodes and links
Changing the name of a node or link only alters it in the scenario that you changed it in. A change in one scenario does not propagate to others; they are not linked in any way. You can change the name of a node or link using one of the following methods:
- To make the Project Explorer visible, choose View » Project Explorer or click its equivalent on the toolbar. In the Project Hierarchy, click the node or link to select it, pause, and click a second time. The name will be prepared for editing (Figure 3). Type the new name and press return; or
- Right-click the node or link in the schematic and choose Rename. The name will be prepared for editing. Type the new name in the field, then press Enter.
Figure 2. Renaming a node or link
Configuring node and link parameters
Use the feature editor of a node/link to configure its parameters, as well as edit them. Refer to About feature editors.
Searching for nodes and links
The Find panel allows you to search for specific nodes and links within open scenarios. Press Ctrl+F to open the Find panel (Figure 4) and enter any part of the element's name as a search term. The result set indicates the scenario containing the node/link along with its type. This is useful when you are working with very large scenarios.
Figure 3. Find panel
Copying and pasting
You can copy and paste a selection of nodes and/or links within or between scenarios in the same project. For multiple component selection, you can click and drag to draw a rectangle over the region with your mouse. Right click and choose Copy. To paste the selection, right click on the Schematic Editor and choose Paste. To duplicate an entire scenario see Projects and scenarios - Copying a scenario.
Be aware of the following when copying some parts of a scenario.
- For copying within a single scenario:
- Copied components are given unique names.
- Functions and variables are not duplicated. The function will list both original and copied components as usages.
- For copying between scenarios:
- Both functions and /wiki/spaces/SD43/pages/53543859 are copied across, but the copy must also contain any nodes that the modelled variable points to.
- Copied functions will be pasted into a new folder named From<OrginatingScenarioName>. This is to prevent duplicate function names by giving them a unique absolute path.
- Functions that are not used by a component are not copied across, even if Force Evaluate is on.
- Restriction curves are not copied across.
- If a water user node with configured crop type(s) is copied, the corresponding crop parameter(s) will also be copied across.
- Scenario options are at the scenario level, so are not copied. To maintain settings of nodes and links that are affected by scenario options (eg. the Storage Processing Method), ensure both originating and destination scenarios have the same scenario option configuration before copying and pasting.
- To copy constituents and their uses across, first create constituents of the same names in the destination scenario.
- For scenario input sets with data sources assigned to copied network components, both the originating and destination scenarios can have different input sets. But, only data sources related to matching scenario input sets will be copied when you copy across.
- Suppose an execution order rule involves two nodes. Copying and pasting both these nodes within or between scenarios will copy the execution order rule.
- Resource assessment systems are not copied within or between scenarios.
- A copied scenario transfer node will lack connection to the original partner node when pasted within or between scenarios.
Deleting nodes and links
Deleting nodes can be achieved simply by selecting the node and pressing the delete key, or by right-clicking it and choosing Delete from the contextual menu. Deleting a link removes only the link. Deleting a node removes both the node and any links that were attached to the node.
Adding notes to nodes and links
You can add a text-based message or note to a node or link. Refer to About notes for more information on notes.
To add (or edit) a note:
- Open the feature editor;
- Right click on the icon (of the node or link); and
- Choose Add Note (or Edit Note) from the contextual menu.
Figure 5 shows how to follow this procedure for an inflow node.
Figure 4. Inflow node, adding/editing a note
Working with nodes
Individual nodes can be rotated, once they are present in the Schematic editor. First, select the node. Then, click on the green dot and rotate the node to your desired position.