Hydraulic network - vcloarec/ReosProject GitHub Wiki

The hydraulic network allows the user to simulate flow propagation in a network. The network is composed of nodes and links between nodes.

Lekan supports the following nodes for simulation:

• junction nodes: nodes with one or more upstream links and one downstream link.
• watershed nodes: nodes associated with a watershed from the watershed module. This type of node can also have upstream links and one downstream link.

The links supported are routing links, which are elements that transform input hydrograph to output hydrograph for simulating flow propagation.

It is also possible to integrate to the network a complete 2D flow models that will take as input and output the connected links.

An hydraulic scheme can be seen as a configuration of the hydraulic network. Project can have several hydraulic schemes and some parameters of elements of the hydraulic network can vary from hydraulic scheme to other one.

User can add new hydraulic scheme with the button and remove the current one by pressing thebutton .

Each hydraulic scheme are associated with a meteorological model that will be use for runoff hydrograph calculation (see [Watershed |Watershed]]) for the whole network. These settings can be changed after pressing the button .

To build a network, the user can add new junction nodes on the map with the dedicated map tool .

Links are added by activating the dedicated map tool and picking first on an upstream node, then on a downstream node.

Adding/removing a watershed node is done with the button at the bottom of the watershed tree.

It is possible to remove all types of selected nodes with the "Remove Hydraulic Element" button .

Once junction nodes are created, the user can move them with the "Move Hydrograph Junction" button . Note that the watershed nodes can't move because these nodes are attached to the outlet of the watershed. However, the user can move the watershed outlet that leads to also moving the watershed node (see "Delineate watershed manually ).

Selecting elements (node or link) on the map after activating the "Select hydraulic Element" map tool , allow the user to display and edit the name of the element.

Once an element is selected, the user can also open the properties windows of this element by clicking on the "Hydraulic Element Properties" button or by double-clicking on the element.

The node parameters can be set in the "Node Parameter" group box.

For the simple junction node, the user can inject a hydrograph from one of the gauged hydrographs associated with this node (see how to associate gauged hydrograph below).

If the check box "Inject Gauged Hydrograph" is checked, the user must choose one of the available hydrographs in the drop-down menu. Then this hydrograph will be summed to the hydrograph coming from upstream links if any. If there is no upstream link, the output of this node will be simply the injected hydrograph, a convenient way to inject any hydrograph into a network.

Properties depending on hydraulic scheme

• if a gauged hydrograph is injected
• which gauged hydrograph is injected

For the watershed nodes, the parameters are also set in the "Node Parameter" group box. Here, the user has to choose either a runoff hydrograph (coming from the runoff hydrograph calculation see Watershed section) or one of the gauged hydrographs associated with the watershed (associated here, see below) or from watershed gauged hydrograph windows).

Properties depending on hydraulic scheme

• if a gauged hydrograph is injected
• which gauged hydrograph is injected
• meteorological model used for runoff hydrograph calculation

Watershed nodes and junction nodes have common properties defined in their windows.

The first option is the "Force output time step option", which can be activated by checking the associated check box.

Once this option is activated, the node's output will have a forced constant time step defined below the check box. The downstream hydrograph will be calculated with this constant time step. That can be convenient to smooth hydrograph or when a downstream method needs a specific time step. For example, the Muskingum routing method validity depends on the input hydrograph time step.

Note that this option is different from "Display constant time step" proposed under the result tables. With this option, only the table has the constant time step, convenient to export by copy/paste results. But here, hydrographs keep their proper time step internally and downstream.

The second common option is access to the gauged hydrographs associated with the node by the following button:

This button open the Gauged Hydrograph Manager where user can add/remove or edit hydrographs.

For watershed nodes, this button leads to the same hydrographs defined by the watershed gauged hydrograph windows.

To add a gauged hydrograph, the user has two options:

• enter manually a new hydrograph after pressing the button
• Import a gauges hydrograph from a external sources using one of the data provider available (button(s) on the top left), see Delft-FEWS provider and Hubeau provider.

Editing a imported hydrograph is only possible if this hydrograph is imported as a copy or if the data provider of this hydrograph allow editing.

All gauged hydrograph can be removed or rename.

Link represents a hydraulic element that transfers flow from a node to another. During this transfer, the hydrograph can be transformed. For now, Lekan provides the following method for transformation:

• The Muskingum routing method: the well now method to take account of lag and attenuation of hydrograph in a reach, with parameter K and x.
• The lag routing method: simply an offset time of the output hydrograph compared to the input hydrograph
• No transformation: no transformation.

Properties depending on hydraulic scheme

• method used for transformation
• parameters of each transformation method.

Hydraulic 2D structure is a complete 2D flow model. This model is connected to the network by links that provide flow input. The output of the model can also be connected to the network to continue the propagation of the flow downstream in any other element.

More details of this more complex element type are presented is a specific part of this documentation: Hydraulic 2D structure.

Properties depending on hydraulic scheme

see Hydraulic 2D structure.

The hydraulic network flow propagation results are available on each element in the properties windows. One result form is plots of each input/output hydrograph. In addition, gauged hydrograph not concerned by the calculation can also be displayed for nodes to compare with results.

The other result form is tables of numerical values of all input/output hydrographs that can be copied/pasted by right-clicking on the table.