TUFLOW SWMM Tutorial Introduction: Difference between revisions

Content deleted Content added
 
(35 intermediate revisions by 5 users not shown)
Line 1:
On request from USA XPSWMM users, TUFLOW linkage with 1D EPA Storm Water Management Model (SWMM) has been added as a supported feature. It is available in TUFLOW 2023-03-AD release or newer. EPA SWMM is a widely used software for simulating urban watershed hydrologic and 1D hydraulic behaviourbehavior. Initially developed in the early 1970's by the USA Environmental Protection Agency (EPA), the software has since undergone numerous updates and enhancements to become one of the most used 1D stormwater runoff and water quality analysis tools globally, particularly in North America. The primary uses of EPA SWMM include designing and evaluating stormwater systems and also planning and assessment of low-impact developmentdevelopments (also known as Water Sensitive Urban Design) techniques. For more details about EPA SWMM, please visit: <u>[https://www.epa.gov/water-research/storm-water-management-model-swmm</font> https://www.epa.gov/water-research/storm-water-management-model-swmm]</u>. Note, if you are not already familiar with TUFLOW, we recommend first completing Module 1 and 2 of the <u>[[Tutorial_Introduction | "TUFLOW Only" Tutorials]]</u> to establish an understanding of 2D modeling, before progressing to learning how to link 1D EPA SWMM to 2D TUFLOW.<br>
 
<br>
This EPA SWMM series of tutorials havehas been written in USA English, instead of British English, for the predominantly USA centered SWMM user base.
 
= Introduction =
The following tutorial models are aimed at new and experienced users, stepping through the process of building and running TUFLOW SWMM together. The main objective aims to demonstrate the ability for TUFLOW to link to 1D EPA SWMM in a variety of different common use case scenarios. <br>
 
'''Note, if you are not already familiar with TUFLOW, we recommend first completing Module 1 and 2 of the <u>[[Tutorial_Introduction | "TUFLOW Only" Tutorials]]</u> to establish an understanding of 2D modeling, before progressing to learning how to link 1D EPA SWMM to 2D TUFLOW.'''<br>
<br>TUFLOW has supported 1D/2D dynamic coupling since its initial 2D solver development in 1989. Traditionally, 1D (1 Dimensional) linking and associated modeling has been applied using TUFLOW's 1D solver, ESTRY. As demonstrated in:
:*<u>[[Tutorial_M03 | Module 3 - 1D Culverts]]</u>
:*<u>[[Tutorial_M05 | Module 5 - Integrated Urban Pipe Network Drainage]]</u>
:*<u>[[Tutorial_M11 | Module 11 - 1D Open Channel]]</u> <br>
EPA SWMM's inclusion in TUFLOW does not replace ESTRY, rather both 1D solvers complement each other. Links to the TUFLOW SWMM tutorials are included in the section below.
 
 
On request from USA XPSWMM users, TUFLOW linkage with 1D EPA Storm Water Management Model (SWMM) has been added as a supported feature. It is available in TUFLOW 2023-03-AD release or newer. EPA SWMM is a widely used software for simulating urban watershed hydrologic and 1D hydraulic behaviour. Initially developed in the early 1970's by the USA Environmental Protection Agency (EPA), the software has since undergone numerous updates and enhancements to become one of the most used 1D stormwater runoff and water quality analysis tools globally, particularly in North America. The primary uses of EPA SWMM include designing and evaluating stormwater systems and also planning and assessment of low-impact development (also known as Water Sensitive Urban Design) techniques. For more details about EPA SWMM, please visit: <u>[https://www.epa.gov/water-research/storm-water-management-model-swmm</font> https://www.epa.gov/water-research/storm-water-management-model-swmm]</u>. Note, if you are not already familiar with TUFLOW, we recommend first completing Module 1 and 2 of the <u>[[Tutorial_Introduction | "TUFLOW Only" Tutorials]]</u> to establish an understanding of 2D modeling, before progressing to learning how to link 1D EPA SWMM to 2D TUFLOW.<br>
<br>
This EPA SWMM series of tutorials have been written in USA English, instead of British English, for the predominantly USA centered SWMM user base.
 
=Software Requirements=
TUFLOW uses QGIS as its Graphical User Interface (GUI), in combination with text editor and spreadsheet software, for its model creation and result viewing. The group of software creates an extremely workflow efficient and flexible modeling environment. Notably, QGIS does not experience the data load/visualisationvisualization lag and display issues some other hydraulic modeling software GUIsGUI's are limited by when working with larger datasets.<br>
 
{| class="wikitable" width="75%"
Line 24 ⟶ 26:
It is recommended to always use the latest release version of TUFLOW.<br>
 
This tutorial model does not require a TUFLOW licencelicense.<br>
 
This tutorial is configured to use a NVIDIA GPU card. If this is not available, your CPU can be used via the Hardware command. <br>
Line 33 ⟶ 35:
 
 
This tutorial was developed using QGIS 3.34 and QGIS TUFLOW Plugin 3.9.0.7311. Please use these or newer versions of QGIS and the plugin. Earlier releases will not include the TUFLOW SWMM automation tools demonstrated in the Tutorials.
 
||<u>[https://qgis.org/endownload/site/forusers/download.html Latest 64-bit version of QGIS]</u>. <br><br>
 
<u>[[TUFLOW_QGIS_Plugin| QGIS TUFLOW Plugin Installation]]</u>.
Line 46 ⟶ 48:
|| <u>[https://notepad-plus-plus.org/downloads/ Latest 64-bit version of Notepad++]</u>. <br><br>
 
<u>[https://wwwdownloads.tuflow.com/Download_archive/Miscellaneous/NPP_TUFLOW_Syntax_Highlighting.zip TUFLOW syntax highlighting for Notepad++]</u>.<br><br>
 
For instructions on configuring Notepad++ for TUFLOW modeling, see <u>[[NotepadPlusPlus_Tips |Notepad++ tips]]</u>.
Line 56 ⟶ 58:
 
=Tutorial Data=
To build the tutorial model, download the dataset below. This includes a digital elevation model (DEM), aerial photography, background model data for the tutorial model and a working version of the model. GeoPackage database has been used as the GIS format for the model build tasks. For tips on using GeopackageGeoPackage databases see <u>[https://wiki.tuflow.com/GeoPackage_Tips GeoPackage Tips]</u>.
:*<u>[https://downloads.tuflow.com/TUFLOW/Wiki_Tute_Models/TUFLOW_SWMM_Tutorial_Models_QGIS_GPKG.zip TUFLOW SWMM Tutorial Dataset - QGIS - GPKG]</u>
 
=Tutorial Modules=
The download dataset contains the input files and working version of the tutorial model for reference. Results and check files are not included to keep the size of the download file manageable,; they canwill be created bywhen running the model simulations. The folder should be placed in a location with write permissions.<br>
 
The tutorial model is presented in a number ofseveral modules. All modules can be completed independently, however new users are encouraged to undertake the modules in sequence:
 
:*<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_M03 | TUFLOW SWMM Module 3]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology
:*<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>[[XPSWMM_to_TUFLOW-SWMM | XPSWMM to TUFLOW SWMM: Automated (Recommended) Approach]]</u> - How to convert an XPSWMM model to TUFLOW SWMM: Automated XPX Conversion Tool Approach.
:*<u>[[XPSWMM_to_TUFLOW-SWMM_Archive | XPSWMM to TUFLOW SWMM: Manual Approach]]</u> - How to convert an XPSWMM model to TUFLOW SWMM: Manual Approach.
 
== TUFLOW SWMM Documentation ==
TUFLOW SWMM documentation can be found in the TUFLOW Manual and in the TUFLOW plugin documentation for the related QGIS tools.
 
* <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u>
* <u>[[TUFLOW QGIS Plugin#Processing_Toolbox|TUFLOW QGIS Plugin Documentation including SWMM tools]]</u>
 
=Recommended Further Reading=
For users who wish to get a better understanding of either 1D EPA SWMM or 2D TUFLOW, the following resources may be of use:
<br><br>
*<u>[https://www.epa.gov/water-research/storm-water-management-model-swmm EPA SWMM User Manual]</u>
*'''EPA SWMM''': <u>[https://www.tuflowepa.comgov/downloadswater-research/#tuflowstorm-water-management-model-swmm TUFLOW User Manualwww.epa.gov]</u>
*<u>[https://docsdownloads.tuflow.com/classic-hpcSWMM/release/2023-03-ADSWMM5_Reference_Manual_Volume1_Hydrology_P100NYRA.pdf TUFLOWSWMM5 Reference Manual 2023-03-AD releaseVolume 1 notes(Hydrology)]</u>
*<u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM5 Reference Manual - Volume 2 (Hydraulics) ]</u>
*<u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydraulics_Addendum-20220210mas2wr.pdf SWMM5 Reference Manual - Volume 2 (Hydraulics Addendum) ]</u>
*<u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume3_Water_Quality_P100P2NY.pdf SWMM5 Reference Manual - Volume 3 (Water Quality) ]</u>
*<u>[https://downloads.tuflow.com/SWMM/swmm-users-manual-version-5.2.pdf EPA SWMM5 User's Manual]</u>
 
 
<br>
'''TUFLOW''': <u>[https://www.tuflow.com www.tuflow.com]</u>
*<u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u>
*<u>[[Tutorial_Introduction#Tutorial_Modules | TUFLOW Tutorial Models]]</u>
 
=Contact=
For comments, requests and feedback contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.<br>
For further training opportunities see <u>[https://tuflow.com/training/training-course-catalogue/ TUFLOW Training Catalogue]</u> and/or contact <u>[mailto:training@tuflow.com training@tuflow.com]</u>. <br>
<br>
 
{{Tips Navigation
|uplink=[[Main_Page| Back to Wiki Main Page]]
}}