Difference between revisions of "QGIS SWMM Convert XPSWMM GIS Inlet Layers to SWMM"

From Tuflow
Jump to navigation Jump to search
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
 
This tool converts an XPSWMM GIS layer with 2D connectivity information for use with TUFLOW-SWMM. The tool works on discharges computed from the equation: '''Q = coefficient * depth<sup>exponent</sup>'''.<br>
 
This tool converts an XPSWMM GIS layer with 2D connectivity information for use with TUFLOW-SWMM. The tool works on discharges computed from the equation: '''Q = coefficient * depth<sup>exponent</sup>'''.<br>
This processing tool generates a GIS layer that can be used with the "Read GIS SWMM Inlet Usage" command to link SWMM inlets to a TUFLOW 2D model.<br>
+
This processing tool generates a GIS layer that can be used with the <font color="blue"><tt>Read GIS SWMM Inlet Usage </tt></font> command to link SWMM inlets to a TUFLOW 2D model.<br>
 
<br>
 
<br>
 
To export the GIS layer required from XPSWMM or the XPSWMM Viewer:
 
To export the GIS layer required from XPSWMM or the XPSWMM Viewer:
 
<ol>
 
<ol>
<li>Right click on the nodes layer and choose 'Export to GIS.'
+
<li>Right click on the nodes layer and choose 'Export to GIS'.
<li>Expand the tree folders 'Hydraulics Node\HDR Node Data'
+
<li>Expand the tree folders 'Hydraulics Node\HDR Node Data'.
<li>Select Node 2D Inflow Capture Flag, Gound Elevation(Spill Crest), 2D Inflow Capture Coefficient, and 2D Inflow Capture Exponent
+
<li>Select Node 2D Inflow Capture Flag, Gound Elevation(Spill Crest), 2D Inflow Capture Coefficient, and 2D Inflow Capture Exponent.
<li>Remove the paranthesis from 'Ground Elevation(Spill Crest).' Required for some versions of QGIS
+
<li>Remove the paranthesis from 'Ground Elevation(Spill Crest)' as it is required for some versions of QGIS.
<li>Set the GIS filename
+
<li>Set the GIS filename.
<li>Click Export
+
<li>Click 'Export'.
 
</ol>
 
</ol>
 
<br>
 
<br>

Revision as of 14:47, 3 January 2024

Introduction

This tool converts an XPSWMM GIS layer with 2D connectivity information for use with TUFLOW-SWMM. The tool works on discharges computed from the equation: Q = coefficient * depthexponent.
This processing tool generates a GIS layer that can be used with the Read GIS SWMM Inlet Usage command to link SWMM inlets to a TUFLOW 2D model.

To export the GIS layer required from XPSWMM or the XPSWMM Viewer:

  1. Right click on the nodes layer and choose 'Export to GIS'.
  2. Expand the tree folders 'Hydraulics Node\HDR Node Data'.
  3. Select Node 2D Inflow Capture Flag, Gound Elevation(Spill Crest), 2D Inflow Capture Coefficient, and 2D Inflow Capture Exponent.
  4. Remove the paranthesis from 'Ground Elevation(Spill Crest)' as it is required for some versions of QGIS.
  5. Set the GIS filename.
  6. Click 'Export'.


The inlets require a name for each combination of coefficient and exponent that must be added to the GIS layer.
Once the layer is setup, run the tool and select the parameters for the appropriate fields. The ground elevation should be used for the 'Inlet elevation field.' The CRS should match the TUFLOW-SWMM project.

Note: For further functionality and an example conversion, see [[]].

Usage

This tool, Convert - XPSWMM GIS inlet layers to SWMM, 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. GIS layer with inlet information: GIS layer to be converted to SWMM.
  2. Inlet name field: Name of the GIS inlet layer.
  3. Inlet elevation field: Elevation of the GIS inlet layer.
  4. Inlet 2d capture flag (1=has 2d connection) field: Determines whether the inlet is connected to the 2D domain.
  5. Inlet discharge equation coefficient field: 'Coefficient' value from the equation above.
  6. Inlet discharge exponent field: 'Exponent' value from the equation above.
  7. Inlet connection width: As the name suggests.
  8. CRS: The CRS (Coordinate Reference System) for the TUFLOW-SWMM project.
  9. SWMM inp file (for inlet definition and curves): Determines the location and filename of the output SWMM inp file.
  10. GeoPackage file for inlet usage (for inlet placement): Determines the location and filename of the output GeoPackage.


XPSWMM to SWMM dialog.png


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