TUFLOW SWMM Tutorial M02: Difference between revisions
Content deleted Content added
Chris Huxley (talk | contribs) |
No edit summary |
||
(299 intermediate revisions by 4 users not shown) | |||
Line 1:
= Introduction =
This tutorial, Module 2 of the TUFLOW SWMM tutorial dataset will demonstrate how to model underground stormwater pipe networks using SWMM, linked to the TUFLOW HPC 2D solution scheme. Boundary condition inflows to the model are defined using TUFLOW's 2D direct rainfall (rain on grid) approach. TUFLOW SWMM Tutorial Module 2 builds from the model created in <u>[[TUFLOW_SWMM_Tutorial_M01|TUFLOW SWMM Tutorial Module 1]]</u>. The completed TUFLOW SWMM Module 1 model is provided in the '''''TUFLOW_SWMM_Module_02\TUFLOW''''' folder of the download dataset as the starting point for this tutorial. If you are not already familiar with TUFLOW SWMM linking, we recommend completing TUFLOW SWMM Module 1 prior to starting this tutorial. <br>
= Project Initialization =
==QGIS==
QGIS Version 3.34 or newer, and QGIS TUFLOW Plugin 3.11 or newer are required to access the SWMM Processing Tools described in the following sections. For installation, see <u>[https://wiki.tuflow.com/TUFLOW_QGIS_Plugin Installation of TUFLOW Plugin]</u>.<br>
Define the Coordinate Reference System (CRS), also called ‘Projection’, for the QGIS workspace:
<ol>
Line 18 ⟶ 17:
{{Video|name=Animation_TS1_Initialization_01a.mp4|width=1235}}<br>
==TUFLOW Model==
===Load and Style TUFLOW Model Files===
Load in the project GIS layers:
<ol>
Line 24 ⟶ 25:
[[File: Tuflow_plugin_load_tcf_layers.png]]<br>
<br>
<li>
<li>In the Load Layers window, select:
* Ordering Options: Alphabetical
* Grouping Options: Group by control file
* Raster Load Options: Load Normally
<li>Click ‘Open’ and ‘OK’.
</ol>
<br>
Style the TUFLOW layers. Suggested styling steps were provided in <u>[[TUFLOW_SWMM_Tutorial_M01#Project_Initialization|TUFLOW SWMM Tutorial M01]]</u>. They have not been duplicated here.<br>
<br>
===TUFLOW Plugin===
Next we need to configure the QGIS TUFLOW Plugin settings to link with the project folder where we will build our model:<br>
<ol>
<li>
<li>Set the CRS (Coordinate Reference System) by selecting one of the vector layers associated with the opened model using the drop menu list. For example, ''2d_bc_M01_001_L''.
<li>To set the location of the TUFLOW folder, click 'Browse...' and navigate to the '''TUFLOW_SWMM_Module_02''' folder. Click 'Select Folder'.
<li>To set the location of the TUFLOW single precision executable file, click 'Browse...' and navigate to the '''exe\2023-03-AF''' folder. Select '''TUFLOW_iSP_w64.exe''' and click 'Open'.
<li>Select 'GPKG' as the GIS Format.
<li>Select 'TUFLOW Classic / HPC' as the TUFLOW Engine.
<li>Tick on 'Save Default Settings Globally'.
<li>Click 'OK'.<br>
<br>
[[File:
</ol>
<br>
=== Increment TUFLOW GeoPackage File ===
We will now save a copy of '''TS01_001.gpkg''' with a new name, '''TS02_001.gpkg'''. This project initialization step is recommended so prior model versions from a project are not broken as a result of changes being made to GIS inputs.
<ol>
<li>In the QGIS Layers Panel, select (left click) '''2d_bc_M01_001_L'''.
<li>Click on the 'Increment Selected Layer' symbol from the TUFLOW Plugin toolbar. This opens the dialog shown below.
<br>
[[File:tuflow_plugin_increment_layer.png]]<br>
<br>
:*Source Layer: Automatically set to the selected layer, '''2d_bc_M01_001_L'''.
:*Output Database: Click 'Browse...'. This will automatically open to the '''TUFLOW\model\gis''' folder. Set the new output database name to '''TS02_001.gpkg''' and click 'Save'.
:*Output Layer Name: This will automatically increment to '''2d_bc_M01_00''2''_L'''. Change the name back to '''2d_bc_M01_00''1''_L'''.
:*Delete the pre-filled 'Incremented Layer' entry in the table. We do not wish to modify the version number associated with the 2d_bc file. This current exercise will not change the version number of any of the GIS layer inputs, it is simply establishing a copy of the existing GeoPackage where future edits will be saved to.
:*Select 'Remove Source Layer from Workspace'.
:*Select 'Increment Layer and Preserve Database'.
<li>Click 'OK'.
<li>The GeoPackage database, '''TS02_001.gpkg''' will now be in the '''TUFLOW_SWMM_Module_02\TUFLOW\model\gis''' folder.
<br><br>
{{Video|name=Animation_TS2_Initialization_02c.mp4|width=1236}}
<br>
</ol>
===Save QGIS Project Workspace===
<ol>
<li>Go to Project > Save As.
<li>Navigate to the '''TUFLOW_SWMM_Module_02''' folder and type '''SWMM_M02''' as the filename with the extension .qgz.
</ol>
<br>
= GIS Inputs =
==Create SWMM GeoPackage Spatial Database==
<ol>
<li>Go to Processing > Toolbox from the top
<li>Go to
:*To set the ‘CRS for GeoPackage’: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
:*To set the ‘Initial SWMM Sections’: Click the …, and tick on
::*'''Nodes--Junctions''', '''Nodes--Outfalls.'''
::*'''Links--Conduits, Links--Streets.'''
::*'''Inlets--Inlets.'''
:*To define the ‘GPKG filename to create’: Click the …, select ‘Save to File’. Navigate to the '''TUFLOW\model\swmm''' folder and save the GeoPackage Database as '''sw02_001.gpkg'''.
::'''Note:''' In Module 1 we also included '''Nodes--Storage''', '''Project--Title''', '''Project--Options''', and '''Project--Report''' in the GeoPackage file. '''Project--Options''' is not required this time as this tutorial model will use two SWMM INP files. The file created during Module 1 (for the road culverts) and the INP is to be created from this GeoPackage (for the underground pipe network inputs). When TUFLOW processes SWMM inputs, it combines the multiple INP files into one before simulation. As such, the details from the Module 1 '''Project--Options''' input will be used in this tutorial. If '''Project--Options''' are included in multiple Geopackage/INP files, the entry that is referenced lowest in the TUFLOW SWMM Control file (TSCF) will be used. '''Nodes--Storage''' will not be used in this tutorial, as these are only needed to represent detention, or for nodes connected using HX boundaries.
<li>Click 'Run'.
<li>Once the tool has finished, click ‘Close’.
<li>In Windows File Explorer, navigate to the '''TUFLOW\model\swmm''' folder and drag and drop '''
<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all vectors within '''sw02_001.gpkg'''. By default, all items in the available list should have been selected.
<li>In the QGIS Layers Panel, move '''sw02_001.gpkg''' to the top of the list. This will ensure the data within this database file is displayed above all other layers in the project.
</ol>
<br>
{{Video|name=Animation_TS2_SWMM_Inputs_01e.mp4|width=1236}}
<br>
== GIS Data Entry ==
A GeoPackage called '''Urban_Development.gpkg''' is provided in the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder. It contains
:*'''Pipes''': defines the underground pipe network location, type and geometry.
:*'''Junctions''': defines the pipe network inlets.
:*'''Outfalls''': defines the pipe network outlet.
<br>
To populate the GeoPackage database created in the previous section:
<ol>
<li>In Windows File Explorer, navigate to the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder. Drag and drop the '''Urban_Development.gpkg''' into QGIS.
<li>
<li>In the QGIS Layers Panel, right click on the '''Pipes''' layer and select 'Zoom to Layer(s)'.
<li>Use the 'Select Features' tool to highlight all items included in '''Pipes'''.
<li>Select 'Edit' from the top QGIS tab and 'Copy Features' from the drop down
<li>
<li>Make the '''Links--Conduits''' layer editable by clicking the 'Toggle Editing' symbol [[File:toggle_editing_icon.png|27x27px]].
<li>Select 'Edit' from the top QGIS tab and click 'Paste Features' from the drop down menu.
<li>Toggle the editing off to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_02d.mp4|width=1236}}<br>
<li>
<li>
<li>Toggle off editing to save the edits.
<li>Remove '''Urban_Development.gpkg'''.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_03c.mp4|width=1236}}<br>
<li>Inspect the attribute information within the respective layers to familiarize yourself with the data.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_04c.mp4|width=1236}}<br>
</ol>
== GIS Data Updates ==
The provided GIS data requires numerous updates, prior to our model simulation. We have built these updates into this tutorial to demonstrate some of the available TUFLOW SWMM model built processing tools.
The following updates are being made to
===Update SWMM Inlet Usage Layer Details===
An Inlet Usage
<ol>
<li>
<li>Navigate to the '''TUFLOW\model\swmm''' folder. Drag and drop '''swmm_iu_TS02_001''' into the QGIS workspace.
</ol>
When you progress from this tutorial to project modeling, you will need to create an Inlet Usage Layer yourself. The template file for this is available from '''model\gis\empty\swmm_iu_empty.gpkg'''. The file is created during the initial 'Write Empty' step of the model build process (refer to <u>[[Tutorial_M01#Project_Initialisation | TUFLOW Tutorial Model 1]]</u>). A summary of the attributes within the Inlet Usage Layer is documented in <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-TUFLOW-1.html#tab:tab-SWMMinletusage TUFLOW 2023-03-AD Release Notes (Table 4.1)]</u>
The 'Inlet' Attribute within '''swmm_iu_TS02_001''' is an ID reference to inlet geometry and associated information listed within '''sw02_001.gpkg''' >> '''Inlets--Inlets'''. A single inlet type, 'Combo1', was referenced in '''swmm_iu_TS02_001''' (the provided Inlet Usage Layer). In recognition of this, we need to create the entry for 'Combo1' in the '''Inlets--Inlets''' layer.
<ol>
<li>In the QGIS Layers Panel, select (left click) '''
<li>Right click
<li>Click
:*Name: Combo1
:*Type: COMBINATION
:*Grate_Length:
:*Grate_Width: 0.
:*Grate_Type: P_BAR-50
:*Curb_Length:
:*Curb_Height: 0.
:*Curb_Throat: VERTICAL
For a summary of the attributes associated with the '''Inlets--Inlets''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Inlets TUFLOW 2023-03-AD Release Notes (Table A.16)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydraulics_Addendum-20220210mas2wr.pdf SWMM5 Reference Manual - Volume 2 (Hydraulics Addendum) ]</u>
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_05c.mp4|width=1236}}
<br>
</ol>
===Update Streets Details===
Street cross-section information is needed for
We will now define this street cross-section type and its attributes.
<ol>
<li>In the QGIS Layers Panel, select (left click) '''Links--Streets''' and toggle on editing.
<li>Right click '''Links--Streets''' and
<li>Click
:*
:*
:*
:*
:*nRoad: 0.014
:*
:*
:*
:*
:*
:*nBack: 0.016
For a summary of the attributes associated with the '''Links--Streets''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Streets TUFLOW 2023-03-AD Release Notes (Table A.24)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_06c.mp4|width=1236}}
<br>
</ol>
===Update Conduit Details===
====Node Details====
The 'From Node' and 'To Node' attribute information in '''Links---Conduits''' is necessary to build the 1D SWMM network. It defines the link/node connections. The information we will be adding to '''Links--Conduits''' is extracted from '''Nodes--Junctions''' and '''Nodes--Outfalls''' automatically using the '<u>[[QGIS_SWMM_Conduits_Assign_Node_Fields |Conduits - Assign node fields]]</u>' tool from the Processing Toolbox.
<ol>
<li>In the QGIS Layers Panel, select (left click) '''Links--Conduits''' and toggle on editing.
<li>In the Processing Toolbox, select the 'Edit Features In-Place' tool [[File:edit_features_in_place_icon.png]]. This allows the editing of an existing layer, instead of the creation of a new layer.
<li>Go to TUFLOW >> SWMM in the processing tool list and select '<u>[[QGIS_SWMM_Conduits_Assign_Node_Fields |Conduits - Assign
<li>Tick on the SWMM Node Layers: '''sw02_001 >> Nodes--Junctions''' and '''sw02_001 >> Nodes--Outfalls'''.
<li>Select 'Modify All Features'.
<li>Once the tool has finished, click 'Close'.
<li>Turn off editing to save the edits.
<li>View the attributes associated within '''Links--Conduits''' to verify the data processing has been completed correctly. The 'From Node' and 'To Node' attribute information is now configured correctly. <br>
For a broader understanding of the other attributes associated with the '''Links--Conduits''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Conduits TUFLOW 2023-03-AD Release Notes (Table A.19)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>. <br>
'''Tip:'''
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_07c.mp4|width=1236}}
<br>
</ol>
====Update Losses====
<ol>
<li>In the QGIS Layers Panel, select (left click) '''Links--Conduits''' and toggle on editing.
<li>In the Processing Toolbox,
<li>Go to TUFLOW >> SWMM in the processing tool list and select '<u>[[QGIS_SWMM_Conduits_Assign_Losses |Conduits - Assign losses]]</u>'. This opens the dialog shown below.
:*
:*Culvert opening - Entrance loss: 0.5
:*Culvert or pipe network outlet - Exit loss: 1.0
:*Pipe Network (manholes and pit inlets):
:::*Entrance loss: 0.2
:::*Exit loss: 0.4
<li>Select 'Modify All Features'.
<li>After the tool processing has finished, click 'Close'.
<li>Turn off editing to save the edits.
<li>View the attributes associated within '''Links--Conduits''' to verify the data processing has been completed correctly. The 'losses_Kentry', 'losses_Kexit' and 'losses_Kavg' attribute information is now configured.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_08d.mp4|width=1236}}
<br>
</ol>
===
The 1D SWMM / 2D TUFLOW linkage locations to connect the pipe network inlets to the surface have been already automatically defined in the SWMM Inlet Usage Layer, '''swmm_iu_TS02_001''', using the 'Conn1D_2D' attribute.
<br>
<ol>
<br>
[[File:swmm_iu_TS02_001_attribute_table_Conn1D2D.png]]
<br>
</ol>
<br>
To complete the pipe network, 1D/2D linkage is needed at the outlet of the pipe network. The '<u>[[QGIS_SWMM_BC_Create_Channel_Endpoint_1D/2D_Connections |BC - Create channel endpoint 1D/2D connections]]</u>' tool will be used to automate this process.
<ol>
<li>In the QGIS Layers Panel, select (left click) '''Links--Conduits'''.
<li>Use the 'Select Features' tool to select the most downstream object in '''Links--Conduits'''.
<li>In the Processing Toolbox, go to TUFLOW >> SWMM and select '<u>[[QGIS_SWMM_BC_Create_Channel_Endpoint_1D/2D_Connections |BC - Create channel endpoint 1D/2D connections]]</u>'. This opens the dialog shown below.
:*Input Conduits Layer: '''Links--Conduits'''
:*Tick on 'Selected features only'
:*Create connections at: 'Downstream end'
:*Offset Distance: 2
:*Length of BC lines: 10
:*Tick on 'Set 2D cell elevation to 1D culvert invert at 1D/2D connection cells if needed'.
:*Output Layer:
<ol>
::<li>Click the ... and select 'Save to GeoPackage'.
::<li>Navigate to the '''TUFLOW\model\
::<li>A dialog will open. In the
::<li>Click 'OK'.
</ol>
<li>Click 'Run'.
<li>Once the tool is finished, click 'Close'.
<li>The '''2d_bc_SWMM_Pipe_Network_Connections_001_L'''
<li>Click the 'Apply TUFLOW Styles to Current Layer' symbol from the TUFLOW Plugin toolbar to style the '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' layer.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_09e.mp4|width=1236}}
<br>
</ol>
===Update SWMM Junction Details===
Line 219 ⟶ 284:
<li>In the QGIS Layers Panel, select (left click) '''Nodes--Junctions''' and toggle on editing.
<li>In the Processing Toolbox, select the 'Edit Features In-Place' tool. This allows the editing of an existing layer, instead of the creation of a new layer.
<li>Go to TUFLOW >> SWMM in the processing tool list and select '
:*Input Inlet Usage Layers: '''
:*Input BC Connection
:*General Options:
:::*Maximum Depth Option (Ymax): 'Set to 0.0'.
:::*Nodes receiving subcatchment flows option (if connected to 2D):
:*Nodes connected to 2D without Inlets
:::*None - leave defaults
:*Nodes
:::*Maximum depth (Ymax) option: 'Use global option'
:::*Ysur: 0 (ignored because ponding > 0.0)
:::*Area of Ponding (Apond): 5
:*Nodes without 2D Connection:
:::*Surcharge Depth: 50
:::*Area of Ponding (Apond): 0.0
<li>Select 'Modify All Features'.
<li>Once the tool has finished, click 'Close'.
<li>Turn off editing to save the edits.
<li>View the attributes associated within '''Nodes--Junctions''' to verify the data processing has been completed correctly. <br>
For a summary of the attributes associated with the '''Nodes--Junctions''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Junctions TUFLOW 2023-03-AD Release Notes (Table A.30)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_10d.mp4|width=1236}}
<br>
</ol>
==SWMM Options==
The model we are building will use two SWMM INP files.
*'''
* We will create a new INP file for the SWMM pipe network inputs (covered in the next
'''Note:''' If '''Project--Options''' are included in multiple GeoPackage/INP files, the entry that is referenced lowest in the TUFLOW SWMM Control File (TSCF) will be used.
<br><br>
== Export SWMM INP File ==
We will now create a new INP file for the SWMM pipe network inputs. To do this, we need to convert '''
<ol>
<li>
<li>This will open the '<u>[[QGIS_SWMM_GeoPackage_Write_to_SWMM_inp |GeoPackage - Write to SWMM inp]]</u>' processing tool, prepopulated with the filename of the layer's GeoPackage. <br>
'''Note:''' This tool can also be activated from the Processing Toolbox.
<li>Click 'Run'.
<li>Once the tool is finished, click 'Close'.
<li>This tool will save the SWMM inp file in the same folder location and with the same name as the GeoPackage input file. In this case, it will save '''sw02_001.inp''' to the '''TUFLOW\model\swmm''' folder.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_11e.mp4|width=1236}}
<br>
</ol>
== TUFLOW Boundary Updates ==
We will be using TUFLOW's 2D direct rainfall (also known as rain on grid) functionality for the catchment inflow boundary condition approach to demonstrate flows into the pipe network inlets. There is a wide range of direct rainfall options built into TUFLOW, including:
*'''Globally uniform rainfall:''' This method applies temporally varied rainfall uniformly (spatially) over the entire model.
*'''Spatially varying rainfall:''' This method applies temporally varied rainfall with spatial variation defined using polygon delineation, grid raster files or inbuilt TUFLOW TIN triangulation routines.<br>
<br>
The focus of this tutorial is not to demonstrate the available direct rainfall options. As such, we will be using the simplest approach, globally uniform rainfall. It does not require any GIS updates to implement the boundary condition change. Updates will be limited to the Boundary Condition Database reference and Control File syntax updates. Both are addressed in the next section. If you are interested in learning about the available direct rainfall options, please refer to <u>[[Tutorial_M06 |TUFLOW Tutorial Module 6]]</u>.
<br>
<ol>
<li>Copy '''rainfall_stations.csv''' from the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder to the '''TUFLOW_SWMM_Module_02\TUFLOW\bc_dbase''' folder.
<li>Copy '''bc_dbase_TS02_001.csv''' from the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder to the '''TUFLOW_SWMM_Module_02\TUFLOW\bc_dbase''' folder.
</ol>
<br>
It is common to use depth varying manning's roughness when using direct rainfall. A Materials File using depth varying inputs has been provided.
<ol>
<li>Copy '''materials_TS02_001.csv''' from the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder to the '''TUFLOW_SWMM_Module_02\TUFLOW\model''' folder.
<br><br>
{{Video|name=Animation_TS2_TUFLOW_Boundary_01a.mp4|width=1235}}
<br>
</ol>
== TUFLOW Geometry Update ==
We will update TUFLOW's 2D elevation and landuse to represent changes associated with the urban development. The updates will be consolidated within '''TS02_001.gpkg'''.
Copy the following TUFLOW geometry inputs to GeoPackage '''TS02_001.gpkg''':
<ol>
<li>Right click anywhere in the QGIS Toolbar Panel and tick on 'Browser Panel' from the 'Panels' options.
<li>Within the QGIS Browser Panel, there is a dropdown directory, 'Project Home'. This directory is a shortcut to the location where the QGIS workspace is saved. In this case, it is a shortcut to the '''TUFLOW_SWMM_Module_02''' folder.
<li>
<li>Drag the following layers (hold Ctrl to select multiple) from the '''Urban_Development.gpkg''' and drop them into the '''TS02_001.gpkg''' contained within the '''TUFLOW_SWMM_Module_02\TUFLOW\model\gis''' folder:
:*'''2d_mat_TS02_Dev_Buildings_001_R'''
:*'''2d_mat_TS02_Dev_Lots_001_R'''
:*'''2d_ztin_TS02_Dev_001_L'''
:*'''2d_ztin_TS02_Dev_001_P'''
:*'''2d_ztin_TS02_Dev_001_R'''
</ol>
'''Note:''' The focus of this tutorial is not to demonstrate 2D geometry updates. If you are interested in learning about the above '''2d_ztin''' and '''2d_mat''' changes, please refer to <u>[[Tutorial_M02 |TUFLOW Tutorial Module 2]]</u>.
<br><br>
<ol>
{{Video|name=Animation_TS2_TUFLOW_Geometry_01f.mp4|width=1236}}
<br>
</ol>
= Simulation Control Files =
To avoid the potential risk of overwriting existing control files accidentally, we will start by saving new control files where we will be making subsequent syntax updates during the following steps.
<ol>
<li>
<li>Using the 'Open File' function in Notepad++:
:*Open '''M02_001.tgc,''' and save the file as '''TS02_001.tgc''' in the '''TUFLOW\model''' folder.
:*
:*
<br>
</ol>
===TUFLOW Control File (TCF)===
<ol>
<li>Open '''TS02_001.tcf''' and make the following reference updates:<br>
<font color="blue"><tt>Spatial Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\TS02_001.gpkg</tt></font> <font color="green"><tt> ! Specify the location of the GeoPackage Spatial Database</tt></font><br>
<font color="blue"><tt>Geometry Control File</tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\TS02_001.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font><br>
<font color="blue"><tt>BC Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\TS02_001.tbc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Boundary
<font color="blue"><tt>BC Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\bc_dbase\bc_dbase_TS02_001.csv</tt></font> <font color="green"><tt> ! Reference the Boundary Condition Database</tt></font><br>
<font color="blue"><tt>Read Materials File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\materials_TS02_001.csv</tt></font> <font color="green"><tt> ! Reference the Materials Definition File</tt></font><br>
<font color="blue"><tt>SWMM Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> ..\model\TS02_001.tscf </tt></font> <font color="green"><tt> ! Reference the SWMM (1D) Control File</tt></font> <br>
<li>Add the following line in the '<font color="green"><tt>Output Settings</tt></font>' section: <br>
<font color="blue"><tt>Map Cutoff Depth </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> 0.05 </tt></font> <font color="green"><tt>! Sets map cutoff depth of 0.05 meters</tt></font> <br>
<li> Save the TCF.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_01d.mp4|width=1235}}
<br>
</ol>
=== TUFLOW Geometry Control File (TGC) ===
<ol>
<li>Open '''TS02_001.tgc'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select 'Open File'.
<li>Add the following command to the the '<font color="green"><tt>Topography</tt></font>' section below the below the existing '<font color="blue"><tt>Read GIS Z Shape</tt></font>' command:<br>
<font color="blue"><tt>Create TIN Zpts </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_ztin_TS02_Dev_001_R | 2d_ztin_TS02_Dev_001_L | 2d_ztin_TS02_Dev_001_P</tt></font> <font color="green"><tt> ! Urban Development Topography TIN</tt></font> <br>
<li>Add the following lines in the '<font color="green"><tt>Materials</tt></font>' section, below the existing material commands : <br>
<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_mat_TS02_Dev_Lots_001_R</tt></font><font color="green"><tt> ! Urban Development Landuse 1</tt></font> <br>
<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_mat_TS02_Dev_Buildings_001_R</tt></font> <font color="green"><tt> ! Urban Development Landuse 2</tt></font> <br>
<li>Save the TGC.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_02b.mp4|width=1235}}
<br>
</ol>
=== TUFLOW Boundary Control File (TBC) ===
<ol>
<li>Open '''TS02_001.tbc'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select
<li> Comment out the 'Read GIS SA' command by placing '!' before the command: <br>
<font color="green"><tt>! Read GIS SA == 2d_sa_M01_001_R</tt></font><br>
<li>Add the following
<font color="blue"><tt>Global Rainfall BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>RF_FC04</tt></font><font color="green"><tt> ! Reads in global rainfall</tt></font><br>
<font color="blue"><tt>
<li>Save the TBC.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_03d.mp4|width=1235}}
<br>
</ol>
=== TUFLOW SWMM Control File (TSCF) ===
<ol>
<li>Open '''TS02_001.tscf'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select 'Open File'.
<li>Add the following command lines after '<font color="blue"><tt>Read SWMM </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\sw01_001.inp</tt></font>': <br>
<font color="blue"><tt>Read SWMM </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\
<font color="blue"><tt>Read GIS SWMM Inlet Usage </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\
<li>Save the TSCF.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_04b.mp4|width=1235}}
<br>
</ol>
= Running the Simulation =
<ol>
<li>Save a copy of '''
<li>Update the batch file to reference the '''TS02_5m_001.tcf''' :<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>"
<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>TS02_5m_001.tcf </tt></font>
<li>
<li>Did your TUFLOW SWMM model fail to run successfully? If so, here is a link to a troubleshooting guide: <u>[[TUFLOW_SWMM_Troubleshooting | TUFLOW SWMM Troubleshooting]]</u>.<br>
<br><br>
{{Video|name=Animation_TS2_Run_Sim_01c.mp4|width=1236}}<br>
</ol>
= Check Files and Results Output=
Complete the steps
<u>[[TUFLOW_SWMM_Tutorial_M02_Check_QGIS | TUFLOW SWMM Tutorial 02 Check Files]]</u> <br>
<u>[[TUFLOW_SWMM_Tutorial_M02_Results_QGIS | TUFLOW SWMM Tutorial 02 Results]]</u> <br>
= Conclusion =
* Simulation results in the 1D SWMM pipe network were viewed in time series and longsection plot format.
=Other TUFLOW SWMM Tutorials=
*<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]]</u> - How to convert an XPSWMM model to TUFLOW SWMM.
<br>
{{Tips Navigation
|uplink=[[TUFLOW_SWMM_Tutorial_Introduction#Tutorial_Modules| Back to TUFLOW SWMM Tutorial Introduction Main Page]]
}}
|