Difference between revisions of "XPSWMM Conversion Reconfigure SWMM Junctions"

From Tuflow
Jump to navigation Jump to search
 
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Update SWMM Nodes--Junctions Attributes ==
+
== Bulk Update SWMM Nodes--Junctions Attributes ==
The following GIS feature update to the '''Nodes--Junctions''' attributes will finalize the SWMM portion of the TUFLOW model. This is typically the final step in the model building process, as the recommended attributes for junction node vary depending on whether the node is associated with inlet usage connections, 1D/2D culvert connections and SWMM hydrology sub-catchments.  
+
The following GIS feature updates to the '''Nodes--Junctions''' attributes will finalize the SWMM portion of the TUFLOW model. This is typically the final step in the model building process, as the recommended attributes for a junction node vary depending on whether the node is associated with inlet usage connections, 1D/2D culvert connections, and SWMM hydrology sub-catchments.  
  
 
<ol>
 
<ol>
 
<li> In the QGIS Layers panel, select (left click) '''Nodes--Junctions''' and toggle on editing.
 
<li> In the QGIS Layers panel, select (left click) '''Nodes--Junctions''' and toggle on editing.
 
<li> In the Processing Toolbox, select the 'Edit Features In-Place' tool. This allows the editing of an existing layer, instead of the creation of a new layer.
 
<li> In the Processing Toolbox, select the 'Edit Features In-Place' tool. This allows the editing of an existing layer, instead of the creation of a new layer.
<li> Go to TUFLOW >> SWMM in the processing tool list and select the '<u>[[QGIS_SWMM_Junctions_Set_Attributes |Junctions - Set attributes ]]</u>' processing tool. This opens the dialog shown below.
+
<li> Go to TUFLOW >> SWMM in the processing tool list and select the '<u>[[QGIS_SWMM_Junctions_Set_Attributes |Junctions - Set attributes]]</u>' processing tool. This opens the dialog shown below.
 
:* Input Subcatchment layers: If available, select '''Hydrology--Subcatchments'''.
 
:* Input Subcatchment layers: If available, select '''Hydrology--Subcatchments'''.
:* Input Inlet Usage Layers: If available, select the inlet usage layer (i.e. '''swmm_iu_XP_001''')
+
:* Input Inlet Usage Layers: If available, select the inlet usage layer (e.g. '''swmm_iu_XP_001''').
:* Input BC Connection Layers: If available, select the 2d_bc connection layer (i.e. '''1D2D_Urban_001_2d_bc_L''').
+
:* Input BC Connection Layers: If available, select the 2d_bc connection layer (e.g. '''1D2D_Urban_001_2d_bc_L''').
 
:* General Options:  
 
:* General Options:  
:::* Maximum Depth Option (Ymax): 'Set to 0.0'.
+
:::* Maximum Depth Option (Ymax): 'Leave as is (applies to edit in place only)'
:::* Nodes receiving subcatchment flows option (if connected to 2D): 'Set Apond = 0.0; Ksur = 0.0 (overwrites options below)'.
+
:::* Nodes receiving subcatchment flows option (if connected to 2D): 'Based on options selected below'
:* Nodes connected to 2D without Inlets:
+
:* Nodes connected to 2D without Inlets (through embankment culvert):
 
:::* Ysur: 0
 
:::* Ysur: 0
:::* Area of ponding: This value should match the 2D cell area associated with 1D/2D culvert connections.
+
:::* Area of ponding: This value should match the 2D cell area associated with 1D/2D culvert connections (100 in the example dataset).
:* Nodes connected to 2D with Inlets:
+
:* Nodes connected to 2D with Inlets (underground pipe network):
 
:::* Maximum depth (Ymax) option: 'Use global option'
 
:::* Maximum depth (Ymax) option: 'Use global option'
 
:::* Ysur: 0
 
:::* Ysur: 0
:::* Area of ponding: This value should match the 2D cell area associated with the Inlet Usage connections.
+
:::* Area of ponding: This value should match the 2D cell area associated with the Inlet Usage connections (25 in the example model).
:* Nodes without 2D Connection:
+
:* Nodes without 2D Connection (underground pipe network):
:::* Surcharge Depth: This value should be a value higher than any expected water level in the model.
+
:::* Surcharge Depth: This value should be a value higher than any expected water level in the model (99 in the example model).
 
:::* Area of ponding: 1
 
:::* Area of ponding: 1
 +
 
<li>Select 'Modify All Features'. Once the tool has finished, click 'Close'.
 
<li>Select 'Modify All Features'. Once the tool has finished, click 'Close'.
 
<li>Turn off editing to save the edits.
 
<li>Turn off editing to save the edits.
Line 27: Line 28:
 
For a summary of the attributes associated with the '''Nodes--Junctions''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Junctions TUFLOW 2023-03-AD Release Notes (Table A.30)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.
 
For a summary of the attributes associated with the '''Nodes--Junctions''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Junctions TUFLOW 2023-03-AD Release Notes (Table A.30)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.
 
<br><br>
 
<br><br>
{{Video|name=Animation_XPtoTUFLOW_1D_model_10a.mp4|width=1350}}
+
{{Video|name=Animation_XPtoTUFLOW_1D_model_13a.mp4|width=1350}}
 +
<br>
 +
</ol>
 +
 
 +
== Selectively Update SWMM Nodes--Junctions Attributes ==
 +
The final step in setting the '''Nodes--Junctions''' attributes requires updating the Ymax (maximum depth) attribute to zero (0) for the nodes within '''Nodes--Junctions''' that are <u>'''not'''</u> connected to the 2D surface via a Pipe Network Pit (Inlet Usage) connection point. Setting the value to zero adjusts the junction node's Ymax to match the distance from its invert to the top of the highest connecting link. <br>
 +
<br>
 +
We can implement this update using a point selection workflow similar to the one described in the '<u>[[XPSWMM_Conversion_Reconfigure_SWMM_Pipe_Network_Data_Archive |Correct the SWMM Nodes--Junction/Outfall Model Design]]</u>' section.
 +
<ol>
 +
<li> In the QGIS Layers panel, select (left click) '''Nodes--Junctions''' and toggle on editing.
 +
<li> Use the 'Select Features' tool to select all nodes included in the '''Nodes--Junctions''' layer. When selected, this will change their color to bright yellow.
 +
<li> In the Processing Toolbox, go to 'Vector Selection' and select 'Select within distance'. This opens the dialog shown below.
 +
:* Select features from: '''Nodes--Junctions''' (this is prepopulated as '''Nodes--Junctions''' is the active dataset).
 +
:* By comparing to the features from: Click the dropdown menu and select the inlet usage layer (e.g. '''swmm_iu_XP_001''').
 +
:* Where the features are within: '0.1 meters'.
 +
:* Modify current selection by: 'removing from current selection'.
 +
<li> Click 'Run'. Once the tool is finished, click 'Close'.
 +
<li> In the QGIS Layers panel, right click '''Nodes--Junctions''' and select 'Open Attribute Table'.
 +
<li> In the attribute table, only some of the junction nodes will be selected. To update the Ymax for the selected nodes:
 +
<ol>
 +
<li> Set the target update column to '''Ymax'''.
 +
<li> In the expression box, set the update value to '''0'''.
 +
<li> Click 'Update Selected'.
 +
</ol>
 +
<li> Close the attribute table.
 +
<li> Toggle editing off to save the edits to '''Nodes--Junctions'''.
 +
<br><br>
 +
{{Video|name=Animation_XPtoTUFLOW_1D_model_14b.mp4|width=1350}}
 
<br>
 
<br>
 
</ol>
 
</ol>
 +
For the provided example dataset, the above workflow should have updated the Ymax value for the junction nodes highlighted red in the image below.<br><br>
 +
[[File: XPSWMM_to_TUFLOW_set_junctions_attributes_01a.png]]<br>
  
 +
== Save the QGIS Workspace ==
 +
In preparation for the next steps of the conversion process, ensure your QGIS workspace has been saved.
 +
<ol>
 +
<li> In QGIS, go to Project > Save from the top dropdown menu options.
 +
</ol>
 +
<br>
  
 +
 +
{{Tips Navigation
 +
|uplink=[[XPSWMM_Conversion_Export_SWMM_INP_Archive | Continue to Next Step: "Export Updated SWMM INP Files"]]
 +
}}
 
{{Tips Navigation
 
{{Tips Navigation
|uplink=[[XPSWMM_to_TUFLOW-SWMM#One Dimensional_(1D)_SWMM_Model_Elements| Back to XPSWMM to TUFLOW Conversion Page]]
+
|uplink=[[XPSWMM_to_TUFLOW-SWMM_Archive#One Dimensional_(1D)_SWMM_Model_Elements| Back to Main XPSWMM to TUFLOW Conversion Page]]
 
}}
 
}}

Latest revision as of 10:00, 20 August 2024

Bulk Update SWMM Nodes--Junctions Attributes

The following GIS feature updates to the Nodes--Junctions attributes will finalize the SWMM portion of the TUFLOW model. This is typically the final step in the model building process, as the recommended attributes for a junction node vary depending on whether the node is associated with inlet usage connections, 1D/2D culvert connections, and SWMM hydrology sub-catchments.

  1. In the QGIS Layers panel, select (left click) Nodes--Junctions and toggle on editing.
  2. In the Processing Toolbox, select the 'Edit Features In-Place' tool. This allows the editing of an existing layer, instead of the creation of a new layer.
  3. Go to TUFLOW >> SWMM in the processing tool list and select the 'Junctions - Set attributes' processing tool. This opens the dialog shown below.
    • Input Subcatchment layers: If available, select Hydrology--Subcatchments.
    • Input Inlet Usage Layers: If available, select the inlet usage layer (e.g. swmm_iu_XP_001).
    • Input BC Connection Layers: If available, select the 2d_bc connection layer (e.g. 1D2D_Urban_001_2d_bc_L).
    • General Options:
    • Maximum Depth Option (Ymax): 'Leave as is (applies to edit in place only)'
    • Nodes receiving subcatchment flows option (if connected to 2D): 'Based on options selected below'
    • Nodes connected to 2D without Inlets (through embankment culvert):
    • Ysur: 0
    • Area of ponding: This value should match the 2D cell area associated with 1D/2D culvert connections (100 in the example dataset).
    • Nodes connected to 2D with Inlets (underground pipe network):
    • Maximum depth (Ymax) option: 'Use global option'
    • Ysur: 0
    • Area of ponding: This value should match the 2D cell area associated with the Inlet Usage connections (25 in the example model).
    • Nodes without 2D Connection (underground pipe network):
    • Surcharge Depth: This value should be a value higher than any expected water level in the model (99 in the example model).
    • Area of ponding: 1
  4. Select 'Modify All Features'. Once the tool has finished, click 'Close'.
  5. Turn off editing to save the edits.
  6. View the attributes within Nodes--Junctions to verify the data processing has been completed correctly.
    For a summary of the attributes associated with the Nodes--Junctions layer, refer to TUFLOW 2023-03-AD Release Notes (Table A.30) and the SWMM Reference Manual - Volume 2 (Hydraulics).


Selectively Update SWMM Nodes--Junctions Attributes

The final step in setting the Nodes--Junctions attributes requires updating the Ymax (maximum depth) attribute to zero (0) for the nodes within Nodes--Junctions that are not connected to the 2D surface via a Pipe Network Pit (Inlet Usage) connection point. Setting the value to zero adjusts the junction node's Ymax to match the distance from its invert to the top of the highest connecting link.

We can implement this update using a point selection workflow similar to the one described in the 'Correct the SWMM Nodes--Junction/Outfall Model Design' section.

  1. In the QGIS Layers panel, select (left click) Nodes--Junctions and toggle on editing.
  2. Use the 'Select Features' tool to select all nodes included in the Nodes--Junctions layer. When selected, this will change their color to bright yellow.
  3. In the Processing Toolbox, go to 'Vector Selection' and select 'Select within distance'. This opens the dialog shown below.
    • Select features from: Nodes--Junctions (this is prepopulated as Nodes--Junctions is the active dataset).
    • By comparing to the features from: Click the dropdown menu and select the inlet usage layer (e.g. swmm_iu_XP_001).
    • Where the features are within: '0.1 meters'.
    • Modify current selection by: 'removing from current selection'.
  4. Click 'Run'. Once the tool is finished, click 'Close'.
  5. In the QGIS Layers panel, right click Nodes--Junctions and select 'Open Attribute Table'.
  6. In the attribute table, only some of the junction nodes will be selected. To update the Ymax for the selected nodes:
    1. Set the target update column to Ymax.
    2. In the expression box, set the update value to 0.
    3. Click 'Update Selected'.
  7. Close the attribute table.
  8. Toggle editing off to save the edits to Nodes--Junctions.


For the provided example dataset, the above workflow should have updated the Ymax value for the junction nodes highlighted red in the image below.

XPSWMM to TUFLOW set junctions attributes 01a.png

Save the QGIS Workspace

In preparation for the next steps of the conversion process, ensure your QGIS workspace has been saved.

  1. In QGIS, go to Project > Save from the top dropdown menu options.



Up
Go-up.png Continue to Next Step: "Export Updated SWMM INP Files"
Up
Go-up.png Back to Main XPSWMM to TUFLOW Conversion Page