Difference between revisions of "QGIS SWMM BC Create Channel Endpoint 1D/2D Connections"

From Tuflow
Jump to navigation Jump to search
 
(28 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This tool creates 1D/2D connections at the endpoints of SWMM channels. HX connections are created on the upstream end and SX connections are created on the downstream end. The connections should be reviewed to ensure that they are correctly positioned.<br>
+
This tool creates 1D/2D connections at the endpoints of SWMM channels. HX connections are created on the upstream end, and SX connections are created on the downstream end. <br>
 +
 
 
'''Note:''' The positions of the HX and SX connections may not be completely accurate, so it is recommended for the user to check the output.  
 
'''Note:''' The positions of the HX and SX connections may not be completely accurate, so it is recommended for the user to check the output.  
 
<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, '''BC - Create channel endpoint 1D/2D connections''', 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 13: Line 14:
 
<ol>
 
<ol>
 
<li>'''Input Conduits Layer:''' The conduits layer to which the 1D/2D connections will be made.  
 
<li>'''Input Conduits Layer:''' The conduits layer to which the 1D/2D connections will be made.  
 +
<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 create 1D/2D connections for the selected channel(s).
 +
<li>'''Create connections at:''' Specifies whether the 1D/2D connections are made at the 'Upstream end', 'Downstream end', or 'Both ends' of the channel(s) in the conduits layer.
 
<li>'''Offset distance:''' Distance from the channel endpoint to the midpoint of the BC line.
 
<li>'''Offset distance:''' Distance from the channel endpoint to the midpoint of the BC line.
<li>'''Length of BC lines:''' As the name suggests.
+
<li>'''Length of BC lines:''' Length of BC lines.
<li>'''Set 2D cell elevation to 1D culvert invert at 1D/2D connection cells if needed:''' If this is checked on, SX and HX boundaries will have the "Flags" attribute set to "Z." This ensures that the valid elevations occur at the 1D/2D interface. HX boundaries require 2D cell elevations at or above the 1D elevation while SX boundaries require 2D cell elevations at or below the 1D elevation.
+
<li>'''Set 2D cell elevation to 1D culvert invert at 1D/2D connection cells if needed:''' If checked on, SX and HX boundaries will have the 'Flags' attribute set to 'Z'. This ensures that valid elevations occur at the 1D/2D interface. HX boundaries require 2D cell elevations at or above the 1D elevation, while SX boundaries require 2D cell elevations at or below the 1D elevation.
<li>'''Output Layer:''' Determines the output file. Details on the options are below.
+
<li>'''Output Layer:''' Determines the location and filename of the output file. It is recommended to name the output layer with the prefix '''2d_bc''' so TUFLOW styles can be automatically applied.
 
</ol>
 
</ol>
 
<br>
 
<br>
[[File:BC_Create_1D2D_dialog.png]]
+
[[File:BC_Create_Channel_Endpoint_1D2D_Connections_Dialog_a.png]]
 
<br><br>
 
<br><br>
  
:'''Output Options:'''<br>
+
== Example ==
:For each of the following options, the tool will output a new layer and won't override any existing files. <br>
+
<br>
:'''Note:''' It is recommended to name the output layer with the prefix '''2d_bc''' so TUFLOW styles can be automatically applied.
+
{{Video|name=Animation_BC_Create_Channel_Endpoint_1D2D_Connections_01d.mp4|width=1236}}
<ol>
 
 
<br>
 
<br>
[[File:output_options_a.png]]
+
Using the 'Selected Features Only' option:
 
<br><br>
 
<br><br>
:<li>Create Temporary Layer:
+
{{Video|name=Animation_BC_Create_Channel_Endpoint_1D2D_Connections_02c.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 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 new 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>
 
  
=== Example ===
 
{{Video|name=.mp4|width=1235}}
 
  
  

Latest revision as of 11:57, 3 May 2024

Introduction

This tool creates 1D/2D connections at the endpoints of SWMM channels. HX connections are created on the upstream end, and SX connections are created on the downstream end.

Note: The positions of the HX and SX connections may not be completely accurate, so it is recommended for the user to check the output.

Usage

This tool, BC - Create channel endpoint 1D/2D connections, 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 Conduits Layer: The conduits layer to which the 1D/2D connections will be made.
  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 create 1D/2D connections for the selected channel(s).
  3. Create connections at: Specifies whether the 1D/2D connections are made at the 'Upstream end', 'Downstream end', or 'Both ends' of the channel(s) in the conduits layer.
  4. Offset distance: Distance from the channel endpoint to the midpoint of the BC line.
  5. Length of BC lines: Length of BC lines.
  6. Set 2D cell elevation to 1D culvert invert at 1D/2D connection cells if needed: If checked on, SX and HX boundaries will have the 'Flags' attribute set to 'Z'. This ensures that valid elevations occur at the 1D/2D interface. HX boundaries require 2D cell elevations at or above the 1D elevation, while SX boundaries require 2D cell elevations at or below the 1D elevation.
  7. Output Layer: Determines the location and filename of the output file. It is recommended to name the output layer with the prefix 2d_bc so TUFLOW styles can be automatically applied.


BC Create Channel Endpoint 1D2D Connections Dialog a.png

Example



Using the 'Selected Features Only' option:


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