XPSWMM to TUFLOW-SWMM: Difference between revisions

Content deleted Content added
 
(10 intermediate revisions by 3 users not shown)
Line 2:
This Wiki page outlines recommended steps for the conversion of an XPSWMM model to TUFLOW. <br>
 
XPSWMM is a flood and urban stormwater drainage modeling software developed by Autodesk (previously Innovyze and XP Solutions). The XPSWMM solution uses EPA SWMM for its 1D calculations, dynamically linked to TUFLOW for its 2D calculations. The software functions within a custom build Graphical User Interface (GUI). Unknown to many XPSWMM modelers, during simulation, XPSWMM processes its inputs into TUFLOW files and also calls TUFLOW for the 2D calculations. As XPSWMM uses TUFLOW for its 2D engine, like-for-like results can be achieved using this software. TUFLOWThe ismodeling theworkflow naturalin replacementTUFLOW fordiffers from XPSWMM, foras peopleTUFLOW whomodeling areis lookingintegrated forwith anQGIS alternative(Geographical solutionInformation followingSystem) Autodesk'sGIS recentsoftware XPSWMMinstead pricing,of licensing,embedded within a software specific andGraphical supportUser changesInterface.
 
Common user feedback suggests the XPSWMM GUI is useful for simple modeling projects; however, it can become cumbersome and workflow inefficient when dealing with larger datasets and/or a large volume of different scenario and event simulations. In response to requests from USA XPSWMM users who want to convert XPSWMM models into a native TUFLOW format, TUFLOW linkage with 1D EPA Storm Water Management Model (SWMM) was added as a supported feature in TUFLOW 2023-03-AD release. The modeling workflow in TUFLOW differs from XPSWMM, as TUFLOW modeling is integrated with QGIS (Geographical Information System) GIS software. This is, however, a net positive. GIS integration is well-suited for working with larger datasets. Additionally, the structural design associated with TUFLOW modeling makes its general workflow extremely efficient, particularly for the automated management of multiple scenarios and events.
 
If you are building a TUFLOW SWMM model from scratch, not from XPSWMM, please refer to the <u>[[TUFLOW_SWMM_Tutorial_Introduction | TUFLOW SWMM Tutorials]]</u>. Tutorials are provided for the following topics:
Line 19 ⟶ 17:
 
If you do not have access to a XPSWMM license and the XPSWMM Application, please refer to the <u>[[XPSWMM_to_TUFLOW-SWMM_Troubleshooting#Model_Conversion_Without_a_XPSWMM_License |XPSWMM to TUFLOW SWMM Troubleshooting]]</u> page. <br>
 
== TUFLOW Licensing / XPSWMM Discount ==
If you are an existing or past XPSWMM perpetual license owner who would like to purchase a TUFLOW license, please contact <u>[mailto::sales@tuflow.com sales@tuflow.com]</u>. You may be eligible for a XPSWMM / TUFLOW discount in recognition of past royalties Autodesk paid TUFLOW if you previously purchased an XPSWMM perpetual license.
 
= XPSWMM to TUFLOW Model Conversion =
Line 63 ⟶ 58:
<li> Run the XPSWMM model to rewrite the TUFLOW files (including the new linkage to the DTM dataset) to the Data folder (go to Analyze > Solve... in top dropdown menu options).
<br><br>
{{Video|name=Animation_XPtoTUFLOW_Export_Data_02aAnimation_XPtoTUFLOW_Export_Data_02b.mp4|width=1350}}
<br>
</ol>
Line 73 ⟶ 68:
<li> When prompted, save the file under an appropriate name (eg '''1D2D_Urban_001.xpx''') to the folder where the XPSWMM model is located.
<br><br>
{{Video|name=Animation_XPtoTUFLOW_Export_Data_03aAnimation_XPtoTUFLOW_Export_Data_03b.mp4|width=1350}}
<br>
</ol>
Line 79 ⟶ 74:
== Convert XPSWMM Model to TUFLOW SWMM ==
Ensure you have QGIS and have the QGIS TUFLOW Plugin installed:
*Install QGIS 3.34 or later: <u>[https://www.qgis.org/endownload/site/forusers/download.html Latest 64-bit version of QGIS]</u>.
*Install the QGIS TUFLOW Plugin by following the instructions, <u>[[TUFLOW_QGIS_Plugin | QGIS TUFLOW Plugin Installation]]</u>.
 
Line 102 ⟶ 97:
<li> Click 'Run'. Once the tool is finished, click 'Close'.
<br><br>
{{Video|name=Animation_XPtoTUFLOW_Convert_01bAnimation_XPtoTUFLOW_Convert_01c.mp4|width=1350}}
<br>
</ol>
Line 114 ⟶ 109:
: '''Note:''' Conversion messages are addressed in further detail here <u>[[XPSWMM_to_TUFLOW-SWMM_Troubleshooting#Common_Conversion_Issues |XPSWMM to TUFLOW SWMM Troubleshooting]]</u>.
* The '''TUFLOW\runs''' folder contains the TCF. If event(s) are specified, the TCF filename with have event placeholder(s), i.e. '_~e1~_~e2~_' (e.g. '''1D2D_Urban_001_~e1~.tcf'''). Again, if event(s) are used, this folder also contains the TUFLOW Event File (TEF) with the event(s) specified. <br>
{{Video|name=Animation_XPtoTUFLOW_Convert_02aAnimation_XPtoTUFLOW_Convert_02b.mp4|width=800}}
<br>
<li> Open QGIS, and click on the ‘Load TUFLOW Layers from TCF’ symbol from the QGIS TUFLOW Plugin toolbar.
Line 131 ⟶ 126:
<li> Inspect the output GIS layers.
<br><br>
{{Video|name=Animation_XPtoTUFLOW_Convert_03aAnimation_XPtoTUFLOW_Convert_03b.mp4|width=1350}}
<br>
</ol>
Line 150 ⟶ 145:
<br>
'''Note:''' A relative path is used for the executable and the TCF, full file path can also be used.
<li>Save the batch file and double click it in Windows File Explorer to run the simulation. This will open the TUFLOW DOS Console Window and the simulation should be executed.
</ol>
 
Line 160 ⟶ 155:
= TUFLOW SWMM Result Viewing =
Are you familiar with loading and viewing TUFLOW results in QGIS? If not, we strongly recommend self-registering and completing our free eLearning:
<u>[https://www.tuflow.com/training/training-course-catalogue/tt001ett001-e-introduction-to-qgis-for-tuflow-elearning/ Introduction to QGIS for TUFLOW]</u>. <br>
 
Our <u>[[TUFLOW_SWMM_Tutorial_Introduction | TUFLOW SWMM Tutorials]]</u> also demonstrate working with TUFLOW SWMM results.
 
Line 176 ⟶ 172:
*<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/SWMM5_User%27s_Manualswmm-users-manual-version-5.2.pdf EPA SWMM5 User's Manual]</u>
 
=Contact=
=Feedback / Suggestions=
WeFor hopecomments, yourequests have found this model conversion page helpful. If you have anyand feedback or suggestions, please emailcontact <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