Hydraulic 2D Editing flow model - vcloarec/ReosProject GitHub Wiki

Editing 2D flow model

Once entered in editing window, several pages allow the user to edit the flow model. The different pages can be chosen from the list on the left of 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. See Boundary conditions about editing boundary conditions.

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 polygons that are associated with element size values. User can add/remove size classes, 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 or by vector layer feature allows 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.

Check mesh quality

When the user is on this page, the quality checking is activated. Each mesh element that does not respect one criteria defined on this page leads to highlight this element on the map. Each criteria is associated with a color that can be changed by the user. Pressing buttons located on the right of criteria leads to zoom on to the extent on all the elements that do not respect the criteria.

Roughness

On this page, the user can draw polygons that are associated with a roughness values (Manning's coefficient). User can add/remove size classes, and then after selecting a class, draw a polygon of this class.

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 or by vector layer feature allows the user to directly use this polygon to draw a new roughness 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.

Simulation configuration

On this page, the user can handle simulation configurations. Depending of the origin of the structure, user can add/remove configuration with the button and . The parameters of a simulation configuration are specific to the engine chosen.

⚠️ **GitHub.com Fallback** ⚠️