Skip to content

Confluence

At a glance…

The confluence node can be used to merge flow pathways. The node is otherwise passive.

[node.walker_confluence]
type = confluence
loc = 20, 30
harmony_fraction = if(node.little_dam.level > 24.0, 1, 0)
ds_1 = my_other_node

Node properties

Property Description
[node.?] (compulsory) Start of node declaration. This says we are creating a node, and also defines the name of the node. Node naming conventions are discussed at . Example: [node.walker_confluence]
type (compulsory) The node type, which is “confluence” in this case. type = confluence
loc (compulsory) The location of the node in cartesian coordinates. Example: loc = 20, 30
harmony_fraction (optional) A dynamic expression that determines the fraction of orders directed up the first upstream link (that is, the first link to this node defined in the model file). Example: harmony_fraction = if(sim.month > 6, 1, 0)
ds_1 (optional) Name of the downstream node. This property defines a downstream link. Inflow nodes may only have 1 downstream link. Example: ds_1 = my_other_node

Results associated with this node

Result Description
dsflow Downstream flow [ML]
usflow Upstream flow [ML]
harmony_fraction The harmony fraction value [proportion between 0 and 1]
ds_1 Downstream flow on link ds_1 [ML]
ds_1_order Orders on the link ds_1 [ML]

How the node works

  • All inflows are passed to the downstream node.

  • Propagation of orders is as follows:

  • The harmony_fraction is evaluated to determine the proportion of orders to be directed to the first upstream link (that is, the first link to this node defined in the model file).
  • The complementary proportion will be directed to the second upstream link.
  • If either upstream branch has a shorter lag time than the other, then the orders designated for the short branch will be delayed by the n timesteps (n = long_branch_lag - short_branch_lag) such that the water would be delivered on the correct timestep to meet downstream orders.
  • This node should not have more than 2 upstream links.

References

None.