Difference between revisions of "EPA SWMM to TUFLOW"

From Tuflow
Jump to navigation Jump to search
Line 1: Line 1:
 
= Introduction =
 
= Introduction =
TUFLOW has supported 1D/2D dynamic coupling since its initial 2D solver development in 1989. Traditionally, 1D linking and associated modeling has been applied using the TUFLOW 1D (ESTRY) solver. New in the 2023-03-AD Release, TUFLOW's 1D linking and solver options have been expanded to support the EPA Storm Water Management Model (referred to herein as EPA SWMM).  
+
TUFLOW has supported 1D/2D dynamic coupling since its initial 2D solver development in 1989. Traditionally, 1D linking and associated modeling has been applied using the TUFLOW 1D (ESTRY) solver. New in the 2023-03-AD Release, TUFLOW's 1D linking and solver options have been expanded to support the EPA Storm Water Management Model (referred to herein as SWMM).  
  
As a result of the 1D EPA SWMM inclusion within TUFLOW, modellers working with EPA SWMM files now have a variety of options available:
+
As a result of the 1D SWMM inclusion within TUFLOW, modellers working with SWMM files now have a variety of options available:
 
<ol>
 
<ol>
<li> Use EPA SWMM, coupled directly to TUFLOW.
+
<li> Use SWMM, coupled directly to TUFLOW.
<li> Conversion of EPA SWMM 1D geometry to a TUFLOW compatible format for use by TUFLOW 1D (ESTRY) solver.
+
<li> Conversion of SWMM 1D geometry to a TUFLOW compatible format for use by TUFLOW 1D (ESTRY) solver.
 
</ol>
 
</ol>
  
= EPA SWMM inclusion in TUFLOW (2023-03-AD or newer)=
+
= SWMM inclusion in TUFLOW (2023-03-AD or newer)=
If you wish to model EPA SWMM coupled dynamically to TUFLOW 2D, please refer to the <u>[[TUFLOW_SWMM_Tutorial_Introduction | TUFLOW SWMM Tutorials]]</u>. Tutorials are provided for the following topics:
+
If you wish to model SWMM coupled dynamically to TUFLOW 2D, please refer to the <u>[[TUFLOW_SWMM_Tutorial_Introduction | TUFLOW SWMM Tutorials]]</u>. Tutorials are provided for the following topics:
 
* <u>[[TUFLOW SWMM Tutorial M01 | TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts
 
* <u>[[TUFLOW SWMM Tutorial M01 | TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts
 
* <u>[[TUFLOW SWMM Tutorial M02 | TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology
 
* <u>[[TUFLOW SWMM Tutorial M02 | TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology
Line 15: Line 15:
 
* <u>[[TUFLOW SWMM Tutorial M04 | TUFLOW SWMM Module 4]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology: Executing multiple different event simulations from a single model control file.
 
* <u>[[TUFLOW SWMM Tutorial M04 | TUFLOW SWMM Module 4]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology: Executing multiple different event simulations from a single model control file.
  
=Conversion of EPA SWMM to TUFLOW 1D (ESTRY)=
+
=Conversion of SWMM to TUFLOW 1D (ESTRY)=
As an alternative to direct coupling of EPA SWMM with TUFLOW, a free utility tool is also available to assist with the conversion of EPA SWMM inp files into a TUFLOW compatible format for simulation using TUFLOW 1D (ESTRY). The SWMM_to_TUFLOW utility is available for download from the <u>[https://www.tuflow.com/Tuflow%20Utilities.aspx TUFLOW website]</u>.<br>
+
As an alternative to direct coupling of SWMM with TUFLOW, a free utility tool is also available to assist with the conversion of SWMM inp files into a TUFLOW compatible format for simulation using TUFLOW 1D (ESTRY). The SWMM_to_TUFLOW utility is available for download from the <u>[https://www.tuflow.com/Tuflow%20Utilities.aspx TUFLOW website]</u>.<br>
  
The EPA SWMM_to_TUFLOW utility automates the conversion of EPA SWMM 1D model geometry for culverts, pipes and open channels into a TUFLOW 1D (ESTRY) compatible GIS and tabular format.<br>
+
The SWMM_to_TUFLOW utility automates the conversion of SWMM 1D model geometry for culverts, pipes and open channels into a TUFLOW 1D (ESTRY) compatible GIS and tabular format.<br>
  
'' Note: TUFLOW 1D does not include an inbuilt hydrology engine. As such, EPA SWMM hydrology and boundary condition information is not processed by this utility. If EPA SWMM hydrology or boundary condition information is important for your model construction, please consider direct coupling of EPA SWMM with TUFLOW.''
+
'' Note: TUFLOW 1D does not include an inbuilt hydrology engine. As such, SWMM hydrology and boundary condition information is not processed by this utility. If EPA SWMM hydrology or boundary condition information is important for your model construction, please use direct coupling of EPA SWMM with TUFLOW.''
  
=Download=
+
== SWMM_to_TUFLOW Utility Execution ==
This page outlines some utilities that may be used to convert EPA SWMM model files into a format which is compatible with TUFLOW. The utilities are available for download from the <u>[https://www.tuflow.com/Tuflow%20Utilities.aspx TUFLOW website]</u>.
+
<ol>
<br>
+
<li> Save swmm_to_gis_w64.''verson''.exe to the same folder as the SWMM file (.inp).
 
+
<li> The utility requires GIS projection information to correctly translate the spatial information contained in the SWMM file (.inp) to either MapInfo *mif/*mid or ESRI/QGIS *.shp format. This is done by including a Projection file in the working directory. Create one of the following files, saved to the same folder location as the SWMM file (.inp).
= Model Conversion Utility (swmm_to_gis.exe) =
 
The swmm_to_gis.exe utility converts EPA SWMM files (.inp) to TUFLOW compatible GIS (mif and shp) format. The utility outputs include:
 
:*T
 
 
 
== Utility Execution ==
 
The utility requires GIS projection information to correctly translate the SWMM file (.inp) from  format to *mif or *.shp format. This is done by including either a projection or header file in the same folder directory as the batch file. The utility will use the projection information from this file for the data conversion.
 
 
<ol>
 
<ol>
<li> mif format input requirement:  Projection.mif or Header.mif
+
<li> *mif/*mid format input requirement:  Projection.mif
<li> shp format input requirement:  Projection.prj or Header.prj
+
<li> *shp format input requirement:  Projection.prj
 
</ol>
 
</ol>
The following error message will be produced if projection information is not available:
+
The following error message will be produced if projection information is not provided:
 
  ERROR - A Header.prj or Projection.prj file does not exist in folder
 
  ERROR - A Header.prj or Projection.prj file does not exist in folder
  

Revision as of 09:51, 5 August 2024

Introduction

TUFLOW has supported 1D/2D dynamic coupling since its initial 2D solver development in 1989. Traditionally, 1D linking and associated modeling has been applied using the TUFLOW 1D (ESTRY) solver. New in the 2023-03-AD Release, TUFLOW's 1D linking and solver options have been expanded to support the EPA Storm Water Management Model (referred to herein as SWMM).

As a result of the 1D SWMM inclusion within TUFLOW, modellers working with SWMM files now have a variety of options available:

  1. Use SWMM, coupled directly to TUFLOW.
  2. Conversion of SWMM 1D geometry to a TUFLOW compatible format for use by TUFLOW 1D (ESTRY) solver.

SWMM inclusion in TUFLOW (2023-03-AD or newer)

If you wish to model SWMM coupled dynamically to TUFLOW 2D, please refer to the TUFLOW SWMM Tutorials. Tutorials are provided for the following topics:

Conversion of SWMM to TUFLOW 1D (ESTRY)

As an alternative to direct coupling of SWMM with TUFLOW, a free utility tool is also available to assist with the conversion of SWMM inp files into a TUFLOW compatible format for simulation using TUFLOW 1D (ESTRY). The SWMM_to_TUFLOW utility is available for download from the TUFLOW website.

The SWMM_to_TUFLOW utility automates the conversion of SWMM 1D model geometry for culverts, pipes and open channels into a TUFLOW 1D (ESTRY) compatible GIS and tabular format.

Note: TUFLOW 1D does not include an inbuilt hydrology engine. As such, SWMM hydrology and boundary condition information is not processed by this utility. If EPA SWMM hydrology or boundary condition information is important for your model construction, please use direct coupling of EPA SWMM with TUFLOW.

SWMM_to_TUFLOW Utility Execution

  1. Save swmm_to_gis_w64.verson.exe to the same folder as the SWMM file (.inp).
  2. The utility requires GIS projection information to correctly translate the spatial information contained in the SWMM file (.inp) to either MapInfo *mif/*mid or ESRI/QGIS *.shp format. This is done by including a Projection file in the working directory. Create one of the following files, saved to the same folder location as the SWMM file (.inp).
    1. *mif/*mid format input requirement: Projection.mif
    2. *shp format input requirement: Projection.prj

    The following error message will be produced if projection information is not provided:

    ERROR - A Header.prj or Projection.prj file does not exist in folder
    

    Example Syntax

    Utility Output

    Example Output