A simple tools for analysis of banks of a river in Qgis; algorytms and scripts are written with Qgis 3 graphical modeler and Python.
(Nov, 25 - 2024)
-
Renamed RBS model in River Banks Segments Cutter. DOWNLOAD & test in your QGIS!: This model separate RiverBanks (RB) into single segments using the stretches of the River Centerline (RC) vector. New elements will inherit the field table values from RC. <- Please refer to built-in user guide!
-
A new model3 called: River Banks Safety Bands Tool. This algorithm generates safety lines at a distance from the riverbanks, which have been previously divided into hydrologically homogeneous segments. For each segment, a buffer distance is determined using a multiplicative factor of the riverbank erosion rate. DOWNLOAD & test in your QGIS! <- Please refer to built-in user guide!
(Nov, 7 - 2024)
-
A new beta-version of River Banks Distance Comparison is released, try it: DOWNLOAD & test in your QGIS! model3 file. In this beta will be added new features:
- Time value inputs of the two riverbanks to compare
- Year erosion rate computing for each transect
Please refer to built-in user guide!
-
(hidden due last update)
Please send us your feedbak! open a issue here on Github or send an email to authors.
- How to use on qgis
- Confined Valley Index
- Riverbanks Distance
- Riverbanks Distance Comparison
- RiverBanks Segments Cutter
- RiverBanks Safety Bands tool
- Disclaimer and Credits
Download the specific model3 files in this repository: all model3 files are running on Qgis 3.28.11 or higher
- Confined Valley Index
- Riverbanks Distance
- River Banks Distance Comparison
- RiverBanks Segments Cutter
- RiverBanks Safety Bands tool
NOTE: If you download file directly from GitHub webpage may assure that the extension of file must be .model3 for properly use in Qgis
- Open Qgis (developed and testet with Qgis 3.28.11)
- Go to Processing sidebar and go to Model icon menu
- Click on "Open existing model" and select the file in your filesystem
v. 1.1 (December 2023)
The algorithm is used to calculate the relationship
| Parameter name | Data Type | Description |
|---|---|---|
| LEFT River Bank | Vector Line | Line of the Left bank |
| RIGHT River Bank | Vector Line | Line of the Right bank |
| River Line | Vector Line | Path of the river |
| Transects STEP | Integer | distance in meters along the path used for creating transects |
| Transects WIDTH | Integer | Lenght in meters of transects across river path |
| Valley Bottom | Polygon | Polygon features that define the Valley Bottom of the river |
Transects are generated, at constant distance from each other along the path, along the river axis; they intersect the right bank, the left bank and the ValleyBottom polygon. The distances between the river axis and the intersections are calculated, the minimum value is taken.
In Output a Vector Points along the river axis containing the calculated data is generated with this attribute table:
| Filed name | Type | Desription |
|---|---|---|
| SEZ-ID | Int | Transect identifier (key field) |
| VB_RB-index | Float | |
| RB-W | Float | Bank width |
| VB-W | Float | ValleyBottom Width |
| min-RB-R | Float | Minimum distance to the Right bank |
| min-RB-L | Float | Minimum distance to the Left bank |
| min-VB-L | Float | Minimum distance to the Left ValleyBottom |
| min-VB-R | Float | Mimimum distance to the Right ValleyBottom |
| transect_d | Float | Progressive distance along river path |
An example of the results is shown in this map. A scaled-type symbology was used using the VB_RB-index field that represent the CVI. Higher values indicate that the valley bottom is further from the river banks. Therefore, in these portions the river is not confined by resistant elements.
--> Download Qgis model3 file
distance between banks and axis of a river along path; useful for morphological analysis.
Centerline of the river is simplyfied into fixed-lenght segments, for each step along the path this model get the distance between centerline and left/right banks.
Here how it works:
- Create nodes along river centerline path, using the input "step"
- Assign a key-value for each nodes called "SEZ-ID"
- Create a new simplified river centerline using nodes
- Create transect across simplified river centerline
- Make a spatial-join with transects and nodes and assign the key-value "SEZ-ID" to transects
- Create nodes of intersection between Transects and banks (Left/Right)
- Add coordinates X/Y of intersection into attribute table
- Spatial join of intersection nodes and Transects, and then assign attribute
- Calculation of distances (Left and Right) using attribute data
- Field cleaning and output.
| Parameter name | Type | Description |
|---|---|---|
| Left Riverbank - RB-L | Linestring | Left bank vector, must contain 1-line feature |
| Right Riverbank - RB-R | Linestring | Right bank vector, must contain 1-line feature |
| River centerline | Linestring | Path of river |
| Step | Integer | Distance in meters along river path from a node to another (*) |
| Transects width | Integer | Width in meters used to generate transects (**) |
(*) A too short step increase computational resource needs and accuracy of data. A too long step decrease accuracy of the output parameters that describe morphology of the river
(**) This value must be large enough, equal to at least twice the maximum distance at which the bank could be to intersect banks. It is used to generate transects orthogonal to the river simplified centerline
This model generate the Transects vector features along path of the river, and intersection nodes. For each transect in attribute table there are Right and Left distance from centerline, useful to calculate banks width.
| Filed name | Type | Description |
|---|---|---|
| SEZ-ID | Int | Transect identifier (key field) |
| min-RB-R | Float | Minimum distance to the Right Bank |
| max-RB-R | Float | Maximum distance to the Right Bank |
| min-RB-L | Float | Minimum distance to the Left Bank |
| max-RB-L | Float | Maxinum distance to the Left Bank |
null value distance is for no intersection between transects and RB
This image is an example of map output. linestring in red are the RB in input, the blue line is the river Centerline
--> Download v.1.4 model3 file
Try a new beta-version: Download beta v.1.4.1 model3 file
The bank distance comparison model (RBDC) is an implementation of RBD with two banks, which is useful in historical comparison analysis or quantitative analysis of the width of river banks in two epochs.
| Parameter name | Type | Description |
|---|---|---|
| River centerline | Linestring | Path of river |
| Step | Integer | Distance in meters along river path from a node to another (*) |
| Time 1 Left Riverbank - T1-RB-L | Linestring | Time 1 Left bank vector, must contain 1-line feature |
| Time 1 Right Riverbank - T1-RB-R | Linestring | Time 1 Right bank vector, must contain 1-line feature |
| Time 2 Left Riverbank - T2-RB-L | Linestring | Time 2 Left bank vector, must contain 1-line feature |
| Time 2 Right Riverbank - T2-RB-R | Linestring | Time 2 Right bank vector, must contain 1-line feature |
| Transects width | Integer | Width in meters used to generate transects (**) |
| Revert-path-direction | Boolean | if checked assignment order of "SEZ-ID" is reverted along path |
(*) A too short step increase computational resource needs and accuracy of data. A too long step decrease accuracy of the output parameters that describe morphology of the river
(**) This value must be large enough, equal to at least twice the maximum distance at which the bank could be to intersect banks. It is used to generate transects orthogonal to the river simplified centerline
This model generate 2 layers:
- a line layer called: "T1-T2 Transects RB distance comparison"
- a point layer called: "Interseciton nodes"
Transects layer contain data about bank distance and their comparison, point layer contain only point of intersection between banks and transects.
The attribute table of Transects layer contain this data:
| Filed name | Type | Description |
|---|---|---|
| SEZ-ID | Int | Transect identifier (key field) |
| T1-min-RB-R | Float | Time 1 Minimum distance to the Right Bank: |
| T1-max-RB-R | Float | Time 1 Maximum distance to the Right Bank: |
| T1-min-RB-L | Float | Time 1 Minimum distance to the Left Bank: |
| T1-max-RB-L | Float | Time 1 Maxinum distance to the Left Bank: |
| T2-min-RB-R | Float | Time 2 Minimum distance to the Right Bank: |
| T2-max-RB-R | Float | Time 2 Maximum distance to the Right Bank: |
| T2-min-RB-L | Float | Time 2 Minimum distance to the Left Bank: |
| T2-max-RB-L | Float | Time 2 Maximum distance to the Left Bank: |
| T2-T1-min-delta-L | Float |
|
| T2-T1-min-delta-R | Float |
|
null value distance is for no intersection between transects and RB
This is an example of results in attribute table
This is an example of results in maps
This model algorytm separate RiverBanks (RB) into single segments using the stretches of the River Centerline (RC) vector. New elements will inherit the field table values from RC.
NOTE: this model is tested with a single-feature vector for inputs
- LBR: Line or multiline feature with Left riverbank to consider.
- RBR: Line or multiline feature with Right riverbank to consider.
- RC stretch: Line or multiline feature with River Centerline to consider.
- River stretch separation lines: This vector contain only geometries used to cut RB. NONE of the field values of this vector will be inherited in the outputs.
- Cut RB with separation lines vector
- Get the max lenght of separation lines feature
- Use "proximity" join (with a threshold distance provided from step #2) to inherit field table values from RC to RB
- LRB: Left RiverBank segments
- RRB: Right RiverBank segments
This algorithm generates safety lines at a distance from the riverbanks, which have been previously divided into hydrologically homogeneous segments. For each segment, a buffer distance is determined using a multiplicative factor of the riverbank erosion rate.
- LEFT side RiverBank: Vector that contain the LEFT side of Riverbank segments. This vector must contain at least a field with the year erosion rate to be used in calculus
- Left Erosion Rate field: Name of the field with values of Erosion Rate
- RIGHT side riverBank: Vector that contain the RIGHT side of Riverbank segments. This vector must contain at least a field with the year erosion rate to be used in calculus
- Right Erosion Rate field: Name of the field with values of Erosion Rate
- M factor for buffers: the multiplicative factor of the erosion rate used to determine the buffer distance from riverbanks
- Create single-side buffer for each of RB usin the formula: $$ D = {{E_r} \cdot {M}} $$
- Union geoprocess to merge the two buffer into one feature
- Dissolve all feature and hole fitting for purify geometric data
- Convert polygon to lines to get output
- Offset line: a MultiLine vector with Bands limit.
This repository contains algorithms that for calculating and analyzing some hydrographic features that are useful for analyses on historical course trends and river geometry.
The work was developed within my research at the University of Catania as Phd student, specific through a Scientific collaboration agreement between the Basin Authority of the Hydrographic District of Sicily (AdB Sicilia) and the Department of Civil Engineering and Architecture (DICaR) of the University of Catania, for hydrological and hydraulic studies for the identification of river belts, for the identification of NWRM (Natural Water Retention Measures), and for the definition of lamination plans of the rivers.
- Gianfranco Di Pietro, PhD student at Università di Catania
- Martina Stagnitti, Researcer at Università di Catania
- Valeria Pennisi, Researcher at Università di Catania
- Rosaria Ester Musumeci, Associate professor of Hydraulics - University of Catania
- Enrico Foti, Full Professor of Hydraulics - University of Catania