Skip to content

Hydraulic 2D structure

vcloarec edited this page Jul 2, 2022 · 26 revisions

Available since experimental version 2.2.90

Hydraulic 2D structure are a hydraulic network type that represent a complete flow 2D model. As a part of a hydaulic network, its bundary conditions can be connected to other part of the network by hydraulic network link.

Create new Hydraulic 2D Structure

To create a new Hydraulic 2D Structure, the user has to select the map tool "Structure 2D":

With this tool, the user has to delineate the domain of the model by digitizing on the map. Note that a right click on an existing vector layer polygon feature allow the user to defined the domain by this polygon.

Hydraulic 2D Structure properties

The entry to Hydraulic 2D Structure is through the properties window of this element (see Hydraulic network).

The tool buttons on top right of the window under the name parameter allow the user to (from left to right):

  • Enter in the window to edit the flow model
  • Launch simulation, export simulation, or change settings of the simulation engine
  • Change settings of scalar rendering on the map: selection of the variable, color ramp settings and mesh frame settings
  • Change settings of vector field rendering: selection of the variable and vector displaying settings
  • Open the 3D view.

Editing the flow model

Once entered in editing, several pages allow the user to edit the flow model. The different pages can be chosen from the list on the left on the window. These pages are:

  • Structure: editing of the structure lines, holes, boundary conditions, and mesh generation algorithm choice.
  • Mesh Resolution: drawing of polygon associated with mesh element sizes, allowing the user to vary the resolution of the mesh.
  • Topography: handling Digital Elevation Models to drap topographies on the mesh.
  • Edit elements / Mesh quality: mesh elements editing and mesh quality checking.
  • Roughness: drawing of polygon associated with roughness value, allowing the user to vary the roughness of the flow model.
  • Simulation Configuration: choosing the simulation engine and simulation settings.

Structure page

Use of buttons on the top of the page:

Activate the tool to edit structure on the map

Switch the map tool to add new lines, note that a right click on an existing vector layer polygon/line feature allow the user to add a structure line corresponding to this polygon/line.

Switch the map tool to add new holes. A hole can be added only on a closed polygon formed by structure lines and that do not share side with the domain polygon. Such existing polygons are highlighted when the mouse cursor hovers it.

Switch the map tool to move vertices or holes.

Switch the map tool to add boundary condition. A boundary condition is defined by selecting two vertices of the domain.

Generate the mesh.

On this page, the user can also choose the algorithm to generate the mesh.

At the bottom, below the boundary condition box, buttons allow the user to delete or rename a boundary condition, or to zoom in on it (all after selecting it in the list).

Mesh Resolution page

On this page, the user can draw polygon that are associated with an element size value. User can add/remove size class, and then after selecting a class draw a polygon of this class. When generating a mesh, the algorithm will use the size value of polygon classes to adapt the mesh element sizes.

The button on the top of the page is used to active the tool to draw polygons on map.

A right click on a closed polygon defined by structures lines allow the user to directly use this polygon to draw a new mesh resolution polygon with the selected class.

To remove a polygon or a part of it, just select the "Default" class and draw a polygon including all the polygon to removed it or a part of it.

Topography page

Elevation values of mesh vertices are deduced from DEM layer(s).

All DEM layers registered in the project are present in "Available DEM", and user can choose which ones to apply on the mesh. When there are more than one layer chosen, the order can be changed by selecting one layer and dragging it to the desired location.

Clicking the "Apply" button leads to drap all the layers on the mesh following this way: for each vertex, if the first DEM layer has a valid value a the position of the vertex, this value is set to the vertex. If not, the second DEL layer is considered, if there is no valid value on the second DEM at the position of the vertex, the third DEM layer is considered, and so on.

Note that the rendering style of elevation of the mesh can be changed after clicking the button "Terrain Styling" on the top of the page.

Edit elements / Mesh quality

Editing mesh elements

On this page, it is possible to elements of the mesh, that is:

  • move/delete vertices
  • flip faces
  • change Z value of vertices

On the top of this page, the button is used to start the edit map tool for mesh element.

To flip two faces, the user can click on the circle that appear on the edge when the mouse cursor hover it.

For selecting vertices, user can:

  • select vertex by left clicking on it
  • select vertices by dragging a rectangle
  • select all vertices of a face by clicking the square on the middle of a face
  • select the two vertices of an edge by clicking the quare on the middle of an edge
  • select vertices by drawing a polygon after a switch with the button on the top of the page

For selecting by rectangle or by polygon, default behavior select all the vertices's of intersected faces. To select only the contained vertices, user has to press Alt key during selection.

Once selected, vertices can be moved by clicking on a selected vertex, or on the square of faces/edges. This first click defined the starting point of the move as the position of the vertex, or the middle of face/edge. The ending point is defined by a second click.

Selected vertices can be removed or have their Z value changed by right click or using the buttons on the top of the page.

Settings for TELEMAC engine

To run TELEMAC simulation from Lekan, it is necessary to setup information in the following window:

If the TELEMAC configuration does not support parallelization, the CPU Usage count has to be set to 1.

This is a side bar

Clone this wiki locally