Tuflow

TUFLOW SWMM Tutorial M04: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(26 intermediate revisions by 3 users not shown)
Line 1:
= Introduction =
This tutorial, Module 4 of the TUFLOW SWMM tutorial dataset will demonstrate TUFLOW's in-bulitbuilt event management functionality. This powerful functionality runs multiple event combinations (e.g. magnitude, duration, temporal patterns, climate change) using a single set of control files, rather than creating a new set of control files for every event simulation. This tutorial demonstrates how event management can be used on a smaller scale, running only 6 models.<br>
The real power of event management is seen when running a model of a much greater size. For example, without implementing event management, a project requiring simulation of the following event combinations would require 144 TCF and bc_dbase files:
:*6 x Event Magnitude: 01%, 2%, 5%, 10%, 20% and 50% Annual Exceedance Probability (AEP)
Line 41:
 
<li>Save a copy of the '''bc_dbase_TS03_001.csv''' as '''bc_dbase_TS04_001.csv'''.
<li>Open the file and make the following updates to the 'Source' column. The '''AEP''' and '''DUR''' wildcards must be between the special character '''~''' to function as a variable. Note, columns E to I are to remain blank. The final '''bc_dbase_TS04_001.csv''' should look like this: <br>
<br>
[[File:SWMM_M04_event_bcdbase_01a.png]]<br>
Line 47:
<li>Save '''bc_dbase_TS04_001.csv'''.
<br><br>
{{Video|name=Animation_TS4_Sim_Control_01aAnimation_TS4_Sim_Control_01b.mp4|width=12351236}}
<br>
</ol>
Line 70:
<li> When TUFLOW runs a simulation, it reads all of the defined events in the TEF, though only uses the event variables specified in the batch file. We will create a compatible batch file shortly.
<br><br>
{{Video|name=Animation_TS4_Sim_Control_02aAnimation_TS4_Sim_Control_02c.mp4|width=12351236}}
<br>
</ol>
Line 85:
<li>Save the TCF.
<br><br>
{{Video|name=Animation_TS4_Sim_Control_03aAnimation_TS4_Sim_Control_03c.mp4|width=12351236}}
<br>
</ol>
Line 94:
 
<li>Update the batch file to reference the '''TS04_5m_~e1~_~e2~_001.tcf''' and include event switches (-e1, -e2) defining event magnitude and event duration:<br>
<font color="blue"><tt>'''set'''</tt></font> <font color="black"><tt>exe</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>"..\..\..\exe\2023-03-AD2026.0.0\TUFLOW_iSP_w64.exe"</tt></font> <br>
<font color="blue"><tt>'''set'''</tt></font> <font color="black"><tt>run</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>start "TUFLOW" /wait</tt></font> <font color="orange"><tt> %exe%</tt></font> <font color="black"><tt> -b</tt></font> <br>
<font color="orange"><tt>%run% </tt></font> <font color="black"><tt> -e1 05p -e2 1hr TS04_5m_~e1~_~e2~_001.tcf </tt></font> <br>
Line 105:
If the model simulation doesn't run, here is a link to some common <u>[[Tutorial_Troubleshooting_QGIS | Trouble Shooting]]</u> advice.
<br><br>
{{Video|name=Animation_TS4_Run_Sim_01aAnimation_TS4_Run_Sim_01c.mp4|width=12351236}}
<br>
</ol>
Line 113:
 
=Advanced Looping Batch File (Optional)=
Looping batch files are a powerful tool to enable high volume simulation management with the least amount syntax, and subsequently manual effort. For example, the following looped batch file executed 1440 simulation using 15 lines of syntax!
<br><br>
[[File:SWMM_M04_advanced_looping_batch_01b.png]]<br>
<br>
 
Line 123 ⟶ 121:
<li>Add the following commands. Indentation is important in batch files, insert tabs to match the below spacing:<br>
<font color="blue"><tt>echo </tt></font> <font color="black"><tt>off</tt></font><br>
<font color="blue"><tt>set </tt></font> <font color="black"><tt>exe</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>"..\..\..\exe\2023-03-AD2026.0.0\TUFLOW_iSP_w64.exe"</tt></font><br>
<font color="blue"><tt>set </tt></font> <font color="black"><tt>run</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>start "TUFLOW" /wait </tt></font><font color="orange"><tt>%exe%</tt></font><font color="black"><tt> -b</tt></font><br>
<br>
Line 140 ⟶ 138:
If the model simulation doesn't run, here is a link to some common <u>[[Tutorial_Troubleshooting_QGIS | Trouble Shooting]]</u> advice.
<br><br>
{{Video|name=Animation_TS4_Run_Sim_02aAnimation_TS4_Run_Sim_02b.mp4|width=12351236}}
<br>
</ol>
Line 167 ⟶ 165:
|}
 
==Check Sucessful Completion of Multiple Simulations==
Open '''_TUFLOW Simulations.log''' from the '''TUFLOW_SWMM_Module_04\TUFLOW\runs''' folder. Confirm 'Finished' is tagged next to the entry for each of the six simulations we executed. This log confirms the model simulation was completed.<br>
<br>
Line 172 ⟶ 171:
<br>
 
==Viewing Multiple Simulation Results==
===Load Results===
Open the simulation results in QGIS. When loading multiple simulations which include 1D results (all with the same object IDs), a two step load workflow is recommended to avoid filling the QGIS layer panel with duplicate 1D object entries.
<ol>
Line 178 ⟶ 179:
[[File:tuflow_plugin_tuflow_viewer.png]]<br>
<br>
<li> Open 1D and 2D results: Select File > 'Load Results'. Navigate to the '''TUFLOW\runs''' folder and select '''TS04_5m_~e1~_~e2~_001.tcf'''.
<li> When asked which simulation to load, select '''TS04_5m_01p_1hr_001'''.
<li> When asked 'Do you want to open result GIS layer?', select 'Yes'.
<li> After '''TS04_5m_01p_1hr_001''' has loaded, open the remaining result files:
* Select File > 'Load Results'. Navigate to the '''TUFLOW\runs''' folder and select '''TS04_5m_~e1~_~e2~_001.tcf'''.
* When asked which simulation to load, select all remaining results (except '''TS04_5m_01p_1hr_001''').
* When asked 'Do you want to open result GIS layer?', select 'No'. All theThe results will nowstill be loaded., Theythough arewill all be associated with the GIS objects loaded for the '''TS04_5m_01p_1hr_001''' simulation.
<li> In the QGIS Layers Panel, move the GIS vector (line and point) layers to the top of the list. This will ensure these layers are displayed above all othermesh result layers in the project.
<br><br>
{{Video|name=Animation_TS4_Results_02aAnimation_TS4_Results_02c.mp4|width=1350}}
<br>
</ol>
 
===Mesh Results (Map Output)===
Inspect the results for all events.
<ol>
<li>Zoom in to the upstream pipe network area.
<li>Click on the scalar dataset 'Depth' under the 'Result Type' in the TUFLOW Viewer 'Map Outputs' list. Toggle on the maximum depth output by clicking the [[File: max_output_icon.png]] symbol.
<li>Click through the results in the 'Open Results' list to observe the different max depth values.
<br><br>
{{Video|name=Animation_TS4_Results_03aAnimation_TS4_Results_03c.mp4|width=1350}}
<br>
</ol>
<li>In the QGIS Layers Panel, select (left click) on the '''TS04_5m_01p_1hr_001_swmm_ts_L''' layer. ▼
 
<li>Use the 'Select Features' tool to highlight 'Pipe 16' (the furthest upstream pipe). ▼
===Vector Results (Pipe Network Output)===
<ol>
▲<li>In the QGIS Layers Panel, select (leftright click) on the '''TS04_5m_01p_1hr_001_swmm_ts_L''', layer.and select 'Show Labels'.
▲<li>Use the 'Select Features' tool to highlight 'Pipe 163' (the furthest upstream pipe).
<li>In the 'Open Results' list, select all 1hr duration event results (hold Ctrl to select multiple).
<li>Click on a scalar dataset 'Flow' under the 'Result Type' in the TUFLOW Viewer 'Time Series' list.
<li>Try multiple combinations of the simulation results to observe how the different events impacted flow through 'Pipe 163'.
<li>Click the 'Refresh Current Plot' [[File: Refreshplotblack.png || 20px]] button to update the plot window after making new selections.
<li>Click the 'Clear Current Plot' [[File: QGIS_Plugin_Icon_ClearPlot.png || 20px]] button to remove all data from the plot window if needed prior to making a new selection.
<br><br>
{{Video|name=Animation_TS4_Results_04aAnimation_TS4_Results_04c.mp4|width=1350}}
<br>
</ol>
Line 213 ⟶ 221:
*Multiple event simulations were run in sequence from a batch file.
*Creation of looped batch file was demonstrated for the efficient execution of bulk simulations.
*Multiple event simulation results were inspected using the QGIS TUFLOW Viewer.
*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>
 
=Other TUFLOW SWMM Tutorials=
*<u>[[TUFLOW_SWMM_Tutorial_M01 | TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts
Line 220 ⟶ 230:
*<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]]</u> - How to convert an XPSWMM model to TUFLOW SWMM.
<br>
{{Tips Navigation
Retrieved from "https://wiki.tuflow.com/TUFLOW_SWMM_Tutorial_M04"