View source for QGIS SWMM Conduits Assign Losses

== 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 supports in-place editing if selected in the QGIS processing window.<br><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.
<br>

== 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>
<br>
[[File:open_processing_toolbox.png]]<br>
<br>

=== 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>
<li>'''Input layer:''' The existing conduits layer that will be assigned the losses fields. 
<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 this is checked on, the tool will only assign losses fields for the channels that have been selected.
<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>'''Entrance loss for channels not furthest upstream:''' The data to populate the 'losses_Kentry' field for the other upstream conduits features.
<li>'''Exit loss furthest downstream channels:''' The data to populate the 'losses_Kexit' field for the furthest downstream conduits features.
<li>'''Exit loss for channels not furthest downstream:''' The data to populate the 'losses_Kexit' field for the other downstream conduits features.
<li>'''Conduits:''' Determines the filename and location of the output conduits layer.
</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.
<br><br>
[[File:Conduits_Assign_Losses_Dialog_01a.png]]
<br><br>

=== Example ===
Using the 'Edit Features In Place' Tool
<br>
{{Video|name=Animation_Conduits_Assign_losses_01a.mp4|width=1235}}
<br>


{{Tips Navigation
|uplink=[[TUFLOW_QGIS_Plugin#Usage| Back to TUFLOW QGIS Plugin Main Page]]
}}