QGIS SWMM Convert XPSWMM GIS Inlet Layers to SWMM

From Tuflow
Jump to navigation Jump to search

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 to 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)." 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.

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. ESTRY Network Layers [optional]: Network layers to be converted and included in the SWMM inp file.
  2. ESTRY Node Layers [optional]: Node layers to be converted and included in the SWMM inp file.
  3. ESTRY Pit Layers [optional]: Pit layers to be converted and included in the SWMM inp file.
  4. ESTRY Table Link Layers [optional]: Table link layers to be converted and included in the SWMM inp file.
  5. ESTRY Pit Inlet Database [optional]: This is required to convert the pit (inlet) curves for use with SWMM.
  6. Reference cell size for inlet connections: The 1D/2D linking for SWMM is always based upon a width while ESTRY can specify (using a negative number) an exact number of cells to use when linking. The reference cell size is used to convert fixed number of linked cells from ESTRY to SWMM.
  7. Network snap tolerance: This is the distance to search for nodes snapped to the endpoint of channels.
  8. Output CRS: The CRS used in the GeoPackage representation of the SWMM inp file.
  9. Create options, and report tables: Whether or not the options and report tables should be generated. This should be yes for stand alone models. No can be used to generate files used for scenarios where these tables are provided in a separate file.
  10. Options table report step (hh:mm:ss): The SWMM report step to use if writing the options table.
  11. Options table minimum surface area: This parameter can help stabilize a model.
  12. SWMM output filename: Determines the location and filename of the output SWMM inp file.
  13. SWMM inlet usage GeoPackage filename: Determines the location and filename of the output GeoPackage.


XPSWMM to SWMM dialog.png

Example



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