|
== Introduction ==
This tool givesprovides 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>
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 Panelpanel, navigate to 'Processing' in the menubar and select 'Toolbox'.<br>
<br>
[[File:open_processing_toolbox.png]]<br>
=== Parameters ===
<ol>
<li>'''Input Layerlayer:''' The existing conduits layer thatto will have be assignedwhich the 'To Node' and 'From Node' fields. Towill onlybe update the fields of some of the layers' features, tick on 'Selected features only'assigned. The tool will only update the fields of the conduits which have been selected.
<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>'''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 outputlocation file.and Detailsfilename onof the optionsoutput areconduits belowlayer.
</ol>
'''Note:''' If 'Edit Feature In-Place' is selected, the tool only requires the 'SWMM Node Layers' parameter. Ie.That Theis, the tool will overwriteoverride the existing conduits file with the updated "'To Node"' and "'From Node"' fields.
<br>
[[File:Assign_Nodes_Dialog.png]]
<br><br>
[[File:Conduits_Assign_Node_Fields_Dialog_b.png]]
'''Output Options:'''<br>
For each of the following options, the tool will create a new conduits layer and won't overwrite the existing one.
:'''Create Temporary Layer:'''
::*Creates a temporary scratch layer. This layer will open into the QGIS workspace but it will '''not''' be saved anywhere.
:'''Save to File...:'''
::*The user can navigate to a folder and save the updated conduits layer to a new GeoPackage Database.
:'''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]]
:'''Save to Database Table...:'''
::*'''<font color=red>???</font>'''
:'''Append to Layer...:'''
::*'''<font color=red>???</font>'''
<br>
[[File:Assign_Nodes_Dialog_output_options.png]]
<br><br>
=== Example ===
Save to an existing GeoPackage:
<br>
{{Video|name=Animation_Assign_Nodes_001bAnimation_Conduits_Assign_Node_Fields_01c.mp4|width=12351236}}
<br><br>
Using 'Edit Feature In-Place' tool: ▼<br>
▲Using the 'Edit Feature In-Place' tool:
{{Video|name=Animation_Assign_Nodes_002b.mp4|width=1235}}
<br><br>
{{Video|name=Animation_Conduits_Assign_Node_Fields_02c.mp4|width=1236}}
{{Tips Navigation
|