QGIS SWMM Convert ESTRY Layers To SWMM

From Tuflow
Jump to navigation Jump to search

Introduction

This tool converts one or more ESTRY layers into a SWMM project (inp) file. It also creates a GeoPackage representation of the SWMM input data with the same name but gpkg extension and an inlet usage filename that can be used with TUFLOW-SWMM models.

This tool is intended to make it easier to convert ESTRY models for use with SWMM. Some of the conversions may not be the optimal representation for SWMM. It is the responsibility of the modeller to check the final model and ensure that it is correct. Hydraulic structures in particular should be reviewed. Pump operations are not converted and must be setup manually. Weirs have a variety of options in both platforms and the automatic conversion may not be the most appropriate SWMM representation. No effort is made to convert TUFLOW operational structures to SWMM controls which must be done manually.

Inlets are always specified as using the Sag option because this is how inlets are used with ESTRY. It may be appropriate to modify SWMM inlets to use the Grade option. This requires the user to provide additional information such as street cross-section and longitudinal slopes.

Some model parameters are defaulted during the process. For example, default street information is created. SWMM pits (inlets) require street information even though this information is not used with the inlets as converted because they are set to use the Sag method. Pits (inlets) use the external inlet usage approach where inlet usage is written to a separate layer that is included in TUFLOW using the command Read GIS SWMM Inlet Usage .
The SWMM model parameters may need to be modified after the conversion process for the model to run stably with low mass errors.

Note: ESTRY channels and links should be converted at the same time. The tool will create nodes as needed if ESTRY uses automatic nodes.

Supported ESTRY layers include:

  • 1D network layers (polylines or points)
  • 1D node layers (points)
  • Pit layers (points)
  • ESTRY table link layers (cross-sections and irregular culvert shapes)


Usage

This tool, Convert - ESTRY 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.


ESTRY to SWMM dialog.png

Example



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