Difference between revisions of "QGIS SWMM Conduits Assign Node Fields"

From Tuflow
Jump to navigation Jump to search
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This tool gives users the ability to reliably and efficiently assign the "To Node" and "From Node" fields of a conduits layer. It identifies the nodes snapped to the endpoints of conduits and assigns the "To Node" and "From Node" appropriately.
+
This tool provides users with the ability to reliably and efficiently assign the 'To Node' and 'From Node' fields of a conduits layer. It identifies the nodes snapped to the endpoints of conduits and assigns the 'To Node' and 'From Node' appropriately.
 
<br>
 
<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.
  
 
== Usage ==
 
== Usage ==
This tool, '''Conduits - Assign node fields''', 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 node fields''', 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 11: Line 11:
 
=== Parameters ===
 
=== Parameters ===
 
<ol>
 
<ol>
<li>'''Input Layer:''' The existing conduits layer that will be assigned the 'To Node' and 'From Node' 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 'To Node' and 'From Node' fields will be assigned.  
<li>'''SWMM Node Layers:''' The existing node layers that are snapped to the endpoints of the conduits.
+
<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 the 'To Node' and 'From Node' fields to the selected channel(s).
<li>'''Conduits:''' Determines the location and filename of the output conduits layer. Details on the options are below.  
+
<li>'''SWMM Node Layers:''' The existing node layers that are snapped to the endpoints of the channel(s) in the conduits layer.
 +
<li>'''Conduits:''' Determines the location and filename of the output conduits layer.  
 
</ol>
 
</ol>
'''Note:''' If 'Edit Feature In-Place' is selected, the tool only requires the 'SWMM Node Layers' parameter. Ie. The tool will overwrite the existing conduits file with the updated "To Node" and "From Node" fields.  
+
'''Note:''' If 'Edit Feature In-Place' is selected, the tool only requires the 'SWMM Node Layers' parameter. That is, the tool will override the existing conduits file with the updated 'To Node' and 'From Node' fields.  
 
<br><br>
 
<br><br>
[[File:Assign_Nodes_Dialog.png]]
+
[[File:Conduits_Assign_Node_Fields_Dialog_b.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 overwrite the existing one.
+
<br>
<ol>
+
{{Video|name=Animation_Conduits_Assign_Node_Fields_01c.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_Node_Fields_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 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>
 
{{Video|name=Animation_Conduits_Assign_Node_Fields_01a.mp4|width=1235}}
 
<br>
 
Using 'Edit Feature In-Place' tool:
 
<br>
 
{{Video|name=Animation_Conduits_Assign_Node_Fields_02a.mp4|width=1235}}
 
<br><br>
 
  
 
{{Tips Navigation
 
{{Tips Navigation
 
|uplink=[[TUFLOW_QGIS_Plugin#Usage| Back to TUFLOW QGIS Plugin Main Page]]
 
|uplink=[[TUFLOW_QGIS_Plugin#Usage| Back to TUFLOW QGIS Plugin Main Page]]
 
}}
 
}}

Latest revision as of 12:19, 3 May 2024

Introduction

This tool provides users with the ability to reliably and efficiently assign the 'To Node' and 'From Node' fields of a conduits layer. It identifies the nodes snapped to the endpoints of conduits and assigns the 'To Node' and 'From Node' appropriately.
This tool supports in-place editing if selected in the QGIS processing window.

Usage

This tool, Conduits - Assign node fields, 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 conduits layer to which the 'To Node' and 'From Node' 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 the 'To Node' and 'From Node' fields to the selected channel(s).
  3. SWMM Node Layers: The existing node layers that are snapped to the endpoints of the channel(s) in the conduits layer.
  4. Conduits: Determines the location and filename of the output conduits layer.

Note: If 'Edit Feature In-Place' is selected, the tool only requires the 'SWMM Node Layers' parameter. That is, the tool will override the existing conduits file with the updated 'To Node' and 'From Node' fields.

Conduits Assign Node Fields Dialog b.png

Example



Using the 'Edit Feature In-Place' tool:


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