Difference between revisions of "QGIS SWMM Conduits Assign Losses"

From Tuflow
Jump to navigation Jump to search
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
−
This tool creates loss geometry and attributes for a SWMM conduit layer. Losses are dependent upon whether a conduit is the furthest upstream, furthest downstream, and which nodes are connected to inlets. Upstream entrance losses are assigned to the furthest upstream channels where the upstream node is not connected to an inlet and other entrance losses assigned to all other conduits (may be 0.0). Downstream exit losses are assigned to the furthest downstream channels and other exit losses are assigned to the rest of the channels (may be 0.0). This tool creates entrance and exit losses specified by the user throughout the domain. Channels that experience atypical size changes may need higher or lower loss coefficients.<br>
+
This tool generates loss geometry and attributes for a SWMM conduit layer. Losses are dependent on whether a conduit is the furthest upstream, furthest downstream, and which nodes are connected to inlets. Upstream entrance losses are assigned to the furthest upstream channels where the upstream node is <u>not</u> connected to an inlet, and other entrance losses are assigned to all other conduits (may be 0.0). Downstream exit losses are assigned to the furthest downstream channels where the downstream node is <u>not</u> connected to an inlet, and other exit losses are assigned to the rest of the channels (may be 0.0). This tool creates entrance and exit losses specified by the user throughout the domain. Channels that experience atypical size changes may need higher or lower loss coefficients.
 +
 
 
This tool supports in-place editing if selected in the QGIS processing window.<br>
 
This tool supports in-place editing if selected in the QGIS processing window.<br>
−
'''Note:''' This tool relies on the "From Node" and "To Node" fields to determine position in the network. The <u>[[QGIS SWMM Conduits Assign Node Fields|Conduits - Assign node fields]]</u> processing tool will ensure the "From Node" and "To Node" fields are correctly assigned.
+
 
 +
'''Note:''' This tool relies on the "From Node" and "To Node" fields to determine the position in the network. The <u>[[QGIS SWMM Conduits Assign Node Fields|Conduits - Assign node fields]]</u> processing tool will ensure the "From Node" and "To Node" fields are correctly assigned.
 
<br>
 
<br>
  
 
== Usage ==
 
== Usage ==
−
This tool, '''Conduits - Assign losses''', 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, '''Conduits - Assign losses''', 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 14:
  
 
=== Parameters ===
 
=== Parameters ===
 +
This tool populates the 'losses_Kentry', losses_Kexit', and 'losses_Kavg' fields of the input conduit layer. The 'losses_Kentry' and losses_Kexit' fields are determined by the input parameters below. The 'losses_Kavg' field is set to 0.0; however if the field is already populated, the tool will not override the existing value.
 
<ol>
 
<ol>
−
<li>'''Input layer:''' The existing conduits layer that will be assigned the losses fields. To only update the fields of some of the layers' features, tick on 'Selected features only'. The tool will only update the fields of the conduits which have been selected.
+
<li>'''Input layer:''' The existing conduits layer to which the losses fields will be assigned.  
 +
<li>'''Selected features only:''' If channel(s) in the conduits layer have been selected using the 'Select Features' tool, this option will become available. If checked on, the tool will only assign losses fields to the selected channel(s).
 
<li>'''Input inlet usage features [optional]:''' The layer containing the physical location of inlets and site specific geometry.  
 
<li>'''Input inlet usage features [optional]:''' The layer containing the physical location of inlets and site specific geometry.  
−
<li>'''Entrance loss furthest upstream channels:''' The data to populate the 'losses_Kentry' field for the furthest upstream conduits features.  
+
<li>'''Culvert opening:'''
−
<li>'''Entrance loss for channels not furthest upstream:''' The data to populate the 'losses_Kentry' field for the other upstream conduits features.
+
:*Entrance Loss: The data to populate the 'losses_Kentry' field for the furthest upstream conduits' features. Default value is 0.5.  
−
<li>'''Exit loss furthest downstream channels:''' The data to populate the 'losses_Kexit' field for the furthest downstream conduits features.
+
<li>'''Culvert or pipe network outlet:'''
−
<li>'''Exit loss for channels not furthest downstream:''' The data to populate the 'losses_Kexit' field for the other downstream conduits features.
+
:*Exit loss: The data to populate the 'losses_Kexit' field for the furthest downstream conduits' features. Default value is 1.0.  
−
<li>'''Conduits:''' Determines the filename and location of the output conduits layer. Details on the output options are below.  
+
<li>'''Pipe network (manholes and pit inlets):'''
 +
:*Entrance loss: The data to populate the 'losses_Kentry' field for the other upstream conduits' features. Default value is 0.2.
 +
:*Exit loss: The data to populate the 'losses_Kexit' field for the other downstream conduits' features. Default value is 0.4.  
 +
<li>'''Output conduits:''' Determines the filename and location of the output conduits layer.
 
</ol>
 
</ol>
−
'''Note:''' If 'Edit Feature In-Place' is selected, the tool does not require the 'Input layer' or the 'Conduits' 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 'Conduits' parameters, as the tool will override the existing conduits file with the updated attributes.
 
<br><br>
 
<br><br>
−
[[File:Assign_Losses_Dialog.png]]
+
[[File:Conduits_Assign_Losses_Dialog_01b.png]]
 
<br><br>
 
<br><br>
  
−
:'''Output Options:'''<br>
+
== Example ==
−
:For each of the following options, the tool will create a new conduits layer and won't override the existing one.
+
<br>
−
<ol>
+
{{Video|name=Animation_Conduits_Assign_Losses_01d.mp4|width=1236}}
 
<br>
 
<br>
−
[[File:Assign_Nodes_Dialog_output_options_02.png]]
+
Using the 'Edit Feature In-Place' tool:
 
<br><br>
 
<br><br>
−
:<li>Create Temporary Layer:
+
{{Video|name=Animation_Conduits_Assign_Losses_02d.mp4|width=1236}}
−
:*Creates a temporary scratch layer. This layer will open into the QGIS workspace but it will '''not''' be saved anywhere.
 
−
:<li>Save to File...:
 
−
:*The user can navigate to a folder and save the updated conduits layer to a new GeoPackage Database.
 
−
:<li>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 conduits layer will be saved as that name in the GPKG.
 
−
::[[File:Layer_Name_dialog.png]]
 
−
:<li>Save to Database Table...:
 
−
:*'''<font color=red>???</font>'''
 
−
:<li>Append to Layer...:
 
−
:*'''<font color=red>???</font>'''<br>
 
−
</ol>
 
−
<br>
 
  
−
=== Example ===
 
−
Save to an existing GeoPackage:
 
−
<br><br>
 
−
{{Video|name=|width=1235}}
 
−
<br>
 
−
Using 'Edit Features In-Place':
 
−
<br><br>
 
−
{{Video|name=|width=1235}}
 
−
<br>
 
  
  

Latest revision as of 12:11, 3 May 2024

Introduction

This tool generates loss geometry and attributes for a SWMM conduit layer. Losses are dependent on whether a conduit is the furthest upstream, furthest downstream, and which nodes are connected to inlets. Upstream entrance losses are assigned to the furthest upstream channels where the upstream node is not connected to an inlet, and other entrance losses are assigned to all other conduits (may be 0.0). Downstream exit losses are assigned to the furthest downstream channels where the downstream node is not connected to an inlet, and other exit losses are assigned to the rest of the channels (may be 0.0). This tool creates entrance and exit losses specified by the user throughout the domain. Channels that experience atypical size changes may need higher or lower loss coefficients.

This tool supports in-place editing if selected in the QGIS processing window.

Note: This tool relies on the "From Node" and "To Node" fields to determine the position in the network. The Conduits - Assign node fields processing tool will ensure the "From Node" and "To Node" fields are correctly assigned.

Usage

This tool, Conduits - Assign losses, 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

This tool populates the 'losses_Kentry', losses_Kexit', and 'losses_Kavg' fields of the input conduit layer. The 'losses_Kentry' and losses_Kexit' fields are determined by the input parameters below. The 'losses_Kavg' field is set to 0.0; however if the field is already populated, the tool will not override the existing value.

  1. Input layer: The existing conduits layer to which the losses fields will be assigned.
  2. Selected features only: If channel(s) in the conduits layer have been selected using the 'Select Features' tool, this option will become available. If checked on, the tool will only assign losses fields to the selected channel(s).
  3. Input inlet usage features [optional]: The layer containing the physical location of inlets and site specific geometry.
  4. Culvert opening:
    • Entrance Loss: The data to populate the 'losses_Kentry' field for the furthest upstream conduits' features. Default value is 0.5.
  5. Culvert or pipe network outlet:
    • Exit loss: The data to populate the 'losses_Kexit' field for the furthest downstream conduits' features. Default value is 1.0.
  6. Pipe network (manholes and pit inlets):
    • Entrance loss: The data to populate the 'losses_Kentry' field for the other upstream conduits' features. Default value is 0.2.
    • Exit loss: The data to populate the 'losses_Kexit' field for the other downstream conduits' features. Default value is 0.4.
  7. Output conduits: Determines the filename and location of the output conduits layer.

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

Conduits Assign Losses Dialog 01b.png

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_Conduits_Assign_Losses&oldid=39529"