Difference between revisions of "QGIS SWMM Outfalls Fix Multiply Connected Links"

From Tuflow
Jump to navigation Jump to search
(Created page with "== Introduction == This tool converts junctions on the downstream side of a network to outfall nodes as required by SWMM. This tool uses the "From node" and "To Node" fields t...")
 
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This tool converts junctions on the downstream side of a network to outfall nodes as required by SWMM. This tool uses the "From node" and "To Node" fields to determine position in the network. Ensure that these fields are populated and up to date.<br>
+
This tool creates a conduit extension to resolve the SWMM error with multiple links connected to the same outfall node, a common issue when converting ESTRY models for use in TUFLOW-SWMM.  
'''Note:''' It is recommended to use the <u>[[QGIS SWMM Conduits Assign Node Fields|Conduits - Assign Node Fields]]</u> tool and the <u>[[QGIS SWMM Integrity Make Node Names Unique|Integrity - Make Node Names Unique]]</u> tool to avoid errors when running the simulation.
+
 
<br>
+
For each multiply connected outfall, this tool generates a new conduit channel and a corresponding junction node. The new junction node is positioned where the initial outfall node was multiply connected. The new conduit channel is then connected to this junction node, and the outfall node is relocated to the outlet of the new channel. The elevation of the outfall node is adjusted according to the input parameters. The newly created extension channel is always an open rectangular channel with the provided attributes.<br>
 +
This tool takes the existing GeoPackage file (with the multiply connected links) and creates a duplicate. The new GeoPackage is then updated with the channel extension(s).
 +
 
 +
'''Note:''' The generated channels may need to be modified to match the real world geometry at the location.
 +
<br><br>
  
 
== Usage ==
 
== Usage ==
This tool can be found in the QGIS processing toolbox panel under 'TUFLOW > SWMM'. To open the Processing Toolbox Panel, navigate to 'Processing' in the menubar and select 'Toolbox'.<br>
+
This tool, '''Outfalls - Fix Multiply Connected Links''', can be found in the QGIS processing toolbox panel under TUFLOW >> SWMM. To open the Processing Toolbox panel, navigate to 'Processing' in the menubar and select 'Toolbox'.<br>
 
<br>
 
<br>
 
[[File:open_processing_toolbox.png]]<br>
 
[[File:open_processing_toolbox.png]]<br>
Line 12: Line 16:
 
=== Parameters ===
 
=== Parameters ===
 
<ol>
 
<ol>
<li>'''Input junctions:''' Use the dropdown menu to select the existing junctions layer that will be updated.  
+
<li>'''GeoPackage in TUFLOW-SWMM Format:''' The input GeoPackage file with multiply connected links.
<li>'''Input conduits:''' Select the ... button and tick on the conduits layer that the junctions are snapped to.  
+
<li>'''Channel extension length:''' The length of the new conduit channel(s). Minimum value is 0.001.
<li>'''New outfalls layer:''' Determines the output file. Details on the options are below.  
+
<li>'''Channel extension width:''' The width of the new conduit channel(s). Minimum value is 0.001.
 +
<li>'''Channel extension maximum depth:''' The depth of the new conduit channel(s). Minimum value is 0.001.
 +
<li>'''Channel extension z-offset for new downstream outlet elevation:''' The difference between the elevation of the upstream node and downstream node. This difference is used to determine the elevation of the new downstream outlet.
 +
<li>'''Channel extension roughness coefficient:''' The Manning's n value for the new conduit channel(s).  
 +
<li>'''GeoPackage output filename:''' Determines the location and filename of the output GeoPackage.
 
</ol>
 
</ol>
 
<br>
 
<br>
[[File:.png]]
+
[[File:Outfalls_Fix_Multiply_Connected_Links_Dialog_a.png]]
 
<br><br>
 
<br><br>
  
'''Output Options:'''<br>
+
== Example ==
For each of the following options, the tool will create a new outfalls layer and won't overwrite the existing one.
 
:'''Create Temporary Layer:'''
 
::*Creates a temporary scratch layer. This layer will open into the QGIS workspace but it will '''not''' be saved anywhere.
 
:'''Save to File...:'''
 
::*The user can navigate to a folder and save the updated outfalls layer to a new GeoPackage Database.
 
:'''Save to GeoPackage...:'''
 
::*The user can navigate to an existing GeoPackage Database. Once selected, a 'Layer Name' dialog will appear. Enter the new layer name, and the updated outfalls layer will be saved as that name in the GPKG.
 
:::[[File:Layer_Name_dialog.png]]
 
:'''Save to Database Table...:'''
 
::*'''<font color=red>???</font>'''
 
:'''Append to Layer...:'''
 
::*'''<font color=red>???</font>'''
 
 
<br>
 
<br>
[[File:.png]]
+
{{Video|name=Animation_Outfalls_Fix_Multiply_Connected_Links_01a.mp4|width=1235}}
<br><br>
 
  
=== Example ===
 
{{Video|name=.mp4|width=1235}}
 
  
  

Latest revision as of 11:29, 29 February 2024

Introduction

This tool creates a conduit extension to resolve the SWMM error with multiple links connected to the same outfall node, a common issue when converting ESTRY models for use in TUFLOW-SWMM.

For each multiply connected outfall, this tool generates a new conduit channel and a corresponding junction node. The new junction node is positioned where the initial outfall node was multiply connected. The new conduit channel is then connected to this junction node, and the outfall node is relocated to the outlet of the new channel. The elevation of the outfall node is adjusted according to the input parameters. The newly created extension channel is always an open rectangular channel with the provided attributes.
This tool takes the existing GeoPackage file (with the multiply connected links) and creates a duplicate. The new GeoPackage is then updated with the channel extension(s).

Note: The generated channels may need to be modified to match the real world geometry at the location.

Usage

This tool, Outfalls - Fix Multiply Connected Links, can be found in the QGIS processing toolbox panel under TUFLOW >> SWMM. To open the Processing Toolbox panel, navigate to 'Processing' in the menubar and select 'Toolbox'.

Open processing toolbox.png

Parameters

  1. GeoPackage in TUFLOW-SWMM Format: The input GeoPackage file with multiply connected links.
  2. Channel extension length: The length of the new conduit channel(s). Minimum value is 0.001.
  3. Channel extension width: The width of the new conduit channel(s). Minimum value is 0.001.
  4. Channel extension maximum depth: The depth of the new conduit channel(s). Minimum value is 0.001.
  5. Channel extension z-offset for new downstream outlet elevation: The difference between the elevation of the upstream node and downstream node. This difference is used to determine the elevation of the new downstream outlet.
  6. Channel extension roughness coefficient: The Manning's n value for the new conduit channel(s).
  7. GeoPackage output filename: Determines the location and filename of the output GeoPackage.


Outfalls Fix Multiply Connected Links Dialog a.png

Example



Up
Go-up.png Back to TUFLOW QGIS Plugin Main Page