Difference between revisions of "QGIS SWMM Junctions Set Attributes"

From Tuflow
Jump to navigation Jump to search
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
−
This tool sets SWMM junction attributes 'Ymax' (maximum depth), 'Ysur' (maximum surcharge depth), and 'Apond' (area of ponding). The junction attributes are set based on generic rules and individual nodes may need to be modified.<br>
+
This tool sets SWMM junction attributes 'Ymax' (maximum depth), 'Ysur' (maximum surcharge depth), and 'Apond' (area of ponding). The junction attributes are set based on generic rules, and individual nodes may need to be modified.<br>
 
This tool supports in-place editing if selected in the QGIS processing window.
 
This tool supports in-place editing if selected in the QGIS processing window.
 
<br><br>
 
<br><br>
Line 13: Line 13:
  
 
<ol>
 
<ol>
−
<li>'''Input layer:''' The junctions layer that will be updated.  
+
<li>'''Input layer:''' The existing junctions layer to be updated.  
−
<li>'''Selected features only:''' If nodes(s) in the junctions layer have been selected using the 'Select Features' tool, this option will become available. If this is checked on, the tool will only update the nodes that have been selected.
+
<li>'''Selected features only:''' If node(s) in the junctions layer have been selected using the 'Select Features' tool, this option will become available. If checked on, the tool will only update the selected node(s).
 
<li>'''Input Subcatchments [optional]:''' The subcatchments layer(s) that the node(s) receive flow from.
 
<li>'''Input Subcatchments [optional]:''' The subcatchments layer(s) that the node(s) receive flow from.
 
<li>'''Input Inlet Usage Layers [optional]:''' The input inlet usage layer(s) that the node(s) are connected to.
 
<li>'''Input Inlet Usage Layers [optional]:''' The input inlet usage layer(s) that the node(s) are connected to.
Line 23: Line 23:
 
'''Note:''' If 'Edit Feature In-Place' is selected, the tool does not require the 'Input layer' or the 'JunctionAtts' parameters as the tool will override the existing junctions file with the updated attributes.
 
'''Note:''' If 'Edit Feature In-Place' is selected, the tool does not require the 'Input layer' or the 'JunctionAtts' parameters as the tool will override the existing junctions file with the updated attributes.
 
<br><br>
 
<br><br>
−
[[File:Junctions_Set_Attributes_Dialog_a.png]]
+
[[File:Junctions_Set_Attributes_Dialog_d.png]]
 
<br><br>
 
<br><br>
  
 
=== Recommended Settings ===
 
=== Recommended Settings ===
  
−
The recommended settings for junctions within the 2D domain depends on whether the node receives flow from a subcatchment and whether and how the node is connected to the 2D domain. <br>
+
The recommended settings for junctions within the 2D domain depend on whether the node receives flow from a subcatchment and whether and how the node is connected to the 2D domain. Below is a description of the input parameters and their recommended values.  
−
'''Note:''' It is recommended that Ymax be set to 0.0 for all junctions. SWMM will set Ymax to highest soffit of connected conduits.
 
 
<br>
 
<br>
 
<ol>
 
<ol>
 
<li>'''General Options:'''  
 
<li>'''General Options:'''  
−
:*'''Maximum Depth Option (Ymax):'''
+
:; Maximum Depth Option (Ymax):
−
::*Set to 0.0: Initializes the Ymax for all junction nodes to 0.0. This option may be overwritten for nodes connected to inlets.
+
::* Set to 0.0:&nbsp; Initializes the Ymax for all junction nodes to 0.0. This option may be overwritten by the parameters set in the 'Nodes connected to 2D with inlets (underground pipe network)' section.  
−
::*Leave as is: Leaves the Ymax value as is for all junction nodes. This option applies for 'Edit Feature In-Place' only.  
+
::* Leave as is:&nbsp; Leaves the Ymax value as is for all junction nodes. This option only applies if using 'Edit Feature In-Place'.  
−
:*'''Nodes receiving subcatchment flows option (if connected to 2D):'''
+
:; Nodes receiving subcatchment flows option (if connected to 2D):
−
::*Based on options selected below: Options set below are applied.  
+
::* Based on options selected below:&nbsp; Parameters set in the following sections will be applied.
−
::*Set Apond = 0.0; Ysur = 0.0 (overwrites options below): Forces subcatchment outlets to yse 0.0 for Ysur and Apond (turns off ponding). When ponding is off, node surcharging is reported as 'flooding' to SWMM and is immediately transferred to the 2D domain.  
+
::* Set Apond = 0.0; Ysur = 0.0 (overwrites options below):&nbsp; Forces subcatchment outlets to use 0.0 for Ysur and Apond (turns off ponding). When ponding is off, node surcharging is reported as 'flooding' to SWMM and is immediately transferred to the 2D domain.  
 +
 
 
<li>'''Nodes connected to the 2D without inlets (through embankment culvert):'''
 
<li>'''Nodes connected to the 2D without inlets (through embankment culvert):'''
−
:*'''Ysur:''' 0.0  
+
: '''Ysur:'''&nbsp; Sets the surcharge at nodes connected to the 2D with inlets. Recommended value is 0.0.
−
:*'''Apond:''' Approximate area of connected 2D cells. A larger area may improve stability, but may artificially attenuate discharges.  
+
: '''Apond:'''&nbsp; Set to the approximate area of the 2D cells associated with the 1D/2D BC culvert connections layer(s). A larger area may improve stability, but may artificially attenuate discharges.  
 +
 
 
<li>'''Nodes connected to 2D with inlets (underground pipe network):'''
 
<li>'''Nodes connected to 2D with inlets (underground pipe network):'''
−
:*'''Maximum depth (Ymax) option (overwrites general setting):'''
+
:; Maximum depth (Ymax) option (overwrites general setting):
−
::*Set to inlet elevation - node elevation: Sets the Ymax value to the inlet elevation minus the node elevation.  
+
::* Set to inlet elevation - node elevation:&nbsp; Sets the Ymax value to the inlet elevation minus the node elevation.  
−
::*Use global option: Sets the Ymax value based on the settings selected in the 'Global options' section.  
+
::* Use global option:&nbsp; Sets the Ymax value based on the parameters set in the 'Global Options' section.  
−
:*'''Ysur:''' Set to 0.0 if using ponding. Otherwise, set to higher than expected depths to prevent flooding.  
+
: '''Ysur:'''&nbsp; Set to 0.0 if using ponding. Otherwise, set to higher than expected depths to prevent flooding.  
−
:*'''Area of ponding:''' Set to the manhole area.  
+
: '''Area of ponding:'''&nbsp; Set to the approximate area of the 2D cells associated with the Inlet Usage connections layer(s).  
−
<li>'''Nodes without a 2D connection (underground pipe network):''' When a node is not connected to the 2D, flood losses will be lost from the model resulting in mass losses and inaccurate results. To prevent this, allow ponding (option 1) or make the surcharge depth high (option 2).  
+
 
−
:*Option 1:
+
<li>'''Nodes without a 2D connection (underground pipe network):'''<br>
−
::*'''Surcharge depth:''' Set to 0.0.
+
When a node is not connected to the 2D, flood losses will be lost from the model resulting in mass losses and inaccurate results. To prevent this, allow ponding (option 1) or make the surcharge depth high (option 2).  
−
::*'''Area of ponding:''' Set to some positive value.
+
:; Option 1:  
−
:*Option 2:
+
::* Surcharge depth:&nbsp; Set to 0.0.
−
::*'''Surcharge depth:''' Set to a value higher than expected node depths.
+
::* Area of ponding:&nbsp; Set to some positive value.
−
::*'''Area of ponding:''' Set to 0.0.
+
:; Option 2:
 +
::* Surcharge depth:&nbsp; Set to a value higher than any expected depth in the model.
 +
::* Area of ponding:&nbsp; Set to 0.0.
 
</ol>
 
</ol>
 +
<br>
  
 
== Example ==
 
== Example ==
−
The following example videos demonstrate junction nodes not receiving subcatchment flows and connected to 2D with a HX boundary (no inlet).<br>
 
 
<br>
 
<br>
−
{{Video|name=Animation_Junctions_Set_Attributes_01b.mp4|width=1235}}
+
{{Video|name=Animation_Junctions_Set_Attributes_01c.mp4|width=1236}}
 
<br>
 
<br>
−
Using the 'Edit Features In-Place':
+
Using the 'Edit Feature In-Place' tool:
 
<br><br>
 
<br><br>
−
{{Video|name=Animation_Junctions_Set_Attributes_02b.mp4|width=1235}}
+
{{Video|name=Animation_Junctions_Set_Attributes_02c.mp4|width=1236}}
 
<br>
 
<br>
  

Latest revision as of 15:46, 26 August 2024

Introduction

This tool sets SWMM junction attributes 'Ymax' (maximum depth), 'Ysur' (maximum surcharge depth), and 'Apond' (area of ponding). The junction attributes are set based on generic rules, and individual nodes may need to be modified.
This tool supports in-place editing if selected in the QGIS processing window.

Usage

This tool, Junctions - Set Attributes, 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. Input layer: The existing junctions layer to be updated.
  2. Selected features only: If node(s) in the junctions layer have been selected using the 'Select Features' tool, this option will become available. If checked on, the tool will only update the selected node(s).
  3. Input Subcatchments [optional]: The subcatchments layer(s) that the node(s) receive flow from.
  4. Input Inlet Usage Layers [optional]: The input inlet usage layer(s) that the node(s) are connected to.
  5. Input BC Connection Layers [optional]: The BC connection layer(s) that connect the node(s) to the 2D domain.
  6. For information on the other input parameters, refer to the Recommended Settings section.
  7. JunctionAtts: Determines the location and filename of the output junctions layer.

Note: If 'Edit Feature In-Place' is selected, the tool does not require the 'Input layer' or the 'JunctionAtts' parameters as the tool will override the existing junctions file with the updated attributes.

Junctions Set Attributes Dialog d.png

Recommended Settings

The recommended settings for junctions within the 2D domain depend on whether the node receives flow from a subcatchment and whether and how the node is connected to the 2D domain. Below is a description of the input parameters and their recommended values.

  1. General Options:
    Maximum Depth Option (Ymax)
    • Set to 0.0:  Initializes the Ymax for all junction nodes to 0.0. This option may be overwritten by the parameters set in the 'Nodes connected to 2D with inlets (underground pipe network)' section.
    • Leave as is:  Leaves the Ymax value as is for all junction nodes. This option only applies if using 'Edit Feature In-Place'.
    Nodes receiving subcatchment flows option (if connected to 2D)
    • Based on options selected below:  Parameters set in the following sections will be applied.
    • Set Apond = 0.0; Ysur = 0.0 (overwrites options below):  Forces subcatchment outlets to use 0.0 for Ysur and Apond (turns off ponding). When ponding is off, node surcharging is reported as 'flooding' to SWMM and is immediately transferred to the 2D domain.
  2. Nodes connected to the 2D without inlets (through embankment culvert):
    Ysur:  Sets the surcharge at nodes connected to the 2D with inlets. Recommended value is 0.0.
    Apond:  Set to the approximate area of the 2D cells associated with the 1D/2D BC culvert connections layer(s). A larger area may improve stability, but may artificially attenuate discharges.
  3. Nodes connected to 2D with inlets (underground pipe network):
    Maximum depth (Ymax) option (overwrites general setting)
    • Set to inlet elevation - node elevation:  Sets the Ymax value to the inlet elevation minus the node elevation.
    • Use global option:  Sets the Ymax value based on the parameters set in the 'Global Options' section.
    Ysur:  Set to 0.0 if using ponding. Otherwise, set to higher than expected depths to prevent flooding.
    Area of ponding:  Set to the approximate area of the 2D cells associated with the Inlet Usage connections layer(s).
  4. Nodes without a 2D connection (underground pipe network):
    When a node is not connected to the 2D, flood losses will be lost from the model resulting in mass losses and inaccurate results. To prevent this, allow ponding (option 1) or make the surcharge depth high (option 2).
    Option 1
    • Surcharge depth:  Set to 0.0.
    • Area of ponding:  Set to some positive value.
    Option 2
    • Surcharge depth:  Set to a value higher than any expected depth in the model.
    • Area of ponding:  Set to 0.0.


Example



Using the 'Edit Feature In-Place' tool:


Up
Go-up.png Back to TUFLOW QGIS Plugin Main Page
Retrieved from "https://wiki.tuflow.com/w/index.php?title=QGIS_SWMM_Junctions_Set_Attributes&oldid=40620"