Tuflow

Tutorial M05: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(8 intermediate revisions by 4 users not shown)
Line 16:
= GIS Inputs =
Create, import and view input data:
:*<u>[[Tutorial_M05_GIS_Inputs_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M05_GIS_Inputs_QGIS_GPKG | QGIS - GPKG]]</u>
<br>
 
Line 37 ⟶ 38:
The pit inlet database assigns a depth discharge relationship to pit inlet types: <br>
<ol>
<li>Create a new folder called ‘pit_dbase’'''pit_dbase''' in the '''Module_05\TUFLOW''' folder.
<li>Navigate to the '''Module_05\Tutorial_Data''', copy and paste the following csv files into the '''Module_05\TUFLOW\pit_dbase''' folder: <br>
*'''pit_inlet_curves.csv'''
*'''pit_inet_dbasepit_inlet_dbase.csv'''
<li>Open the '''pit_inlet_dbase'''. The three different names are user defined inlet types matching the attribute in 1d_nwk pits file. They define the inflow into the pit depending on the above ground water depth and are derived based on the geometry of the pits. These can be unique to every model. From the '''pit_inlet_dbase''', ‘AB’ inlet type has an area of 0.54m<sup>2</sup> and width of 3.6m and references the ‘Type AB’ in the flow column from the '''pit_inlet_curves''' file.<br>
<br>
[[File:M05 pit inlet dbase_01.png]]<br>
<br>
<li>Open the '''pit_inlet_curves''', it defines the depth discharge relationship for each pit inlet type.
<li>Plot the depth against flow for each pit type to view the relationship. The curves are the limiting factor for the amount of flow entering the pits. <br>
<br>
Line 58 ⟶ 59:
<ol>
<li>Save a copy of '''M02_001.tgc''' as '''M05_001.tgc''' in the '''Module_05\TUFLOW\model''' folder.
<li>Open the file '''M05_001.tgc''' in a text editor and add the additional linesline below the '<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M02_rd_crest_001_L.shp | gis\2d_zsh_M02_rd_crest_001_P.shp</tt></font>' command: <br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Create TIN Zpts </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M02_landscape_002_R.shp | gis\2d_zsh_M02_landscape_002_L.shp | gis\2d_zsh_M02_landscape_002_P.shp</tt></font> <font color="green"><tt> ! Defines areas of complex landscaping</tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<li>Add in the following line after the '<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_mat_M01_001_R.shp</tt></font>' command.<br>▼
<font color="blue"><tt>Create TIN Zpts </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_zsh_M02_landscape_002_R | 2d_zsh_M02_landscape_002_L | 2d_zsh_M02_landscape_002_P</tt></font> <font color="green"><tt> ! Defines areas of complex landscaping</tt></font> <br>
▲<li>Add in the following line after the '<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_mat_M01_001_R.shp</tt></font>' command.<br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_mat_M02_landscape_002_R.shp </tt></font> <font color="green"><tt> ! Sets the material values according to attributes in the GIS layer</tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<font color="blue"><tt>Read GIS Mat </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_mat_M02_landscape_002_R </tt></font> <font color="green"><tt> ! Sets the material values according to attributes in the GIS layer</tt></font> <br>
Assigns the updated materials values due to the development.
<li>Save the TGC.
Line 71 ⟶ 78:
<li>Save a copy of '''M01_001.tbc''' as '''M05_001.tbc''' in the '''Module_05\TUFLOW\model''' folder.
<li>Open the file '''M05_001.tbc''' in a text editor and add the following two commands:<br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Read GIS SA PITS </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_sa_M05_001_R.shp</tt></font> <font color="green"><tt> ! Reads in 2D boundaries directly to 1D pits</tt></font> <br>
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_M05_outlet_001_L.shp</tt></font> <font color="green"><tt> ! Reads in 2D boundaries from 1D network</tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<font color="blue"><tt>Read GIS SA PITS </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_sa_M05_001_R</tt></font> <font color="green"><tt> ! Reads in 2D boundaries directly to 1D pits</tt></font> <br>
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_bc_M05_outlet_001_L</tt></font> <font color="green"><tt> ! Reads in 2D boundaries from 1D network</tt></font> <br>
<li>Save the TBC.
</ol>
Line 82 ⟶ 93:
<li>Create a new text file called '''M05_001.ecf''' and save it in the '''Module_05\TUFLOW\model''' folder.
<li>Add the following command lines:<br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>0.5</tt></font> <font color="green"><tt> ! Specifies a 1D computational timestep as 0.5 seconds</tt></font> <br>
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_M05_pipes_001_L.shp</tt></font> <font color="green"><tt> ! Defines pipes</tt></font> <br>
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_M05_pits_001_P.shp</tt></font> <font color="green"><tt> ! Defines pits </tt></font> <br>
<font color="blue"><tt>Pit Inlet Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\pit_dbase\pit_inlet_dbase.csv</tt></font> <font color="green"><tt> ! Pit inlet database defining depth-discharge curves </tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>0.5</tt></font> <font color="green"><tt> ! Specifies a 1D computational timestep as 0.5 seconds</tt></font> <br>
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>1d_nwk_M05_pipes_001_L</tt></font> <font color="green"><tt> ! Defines pipes</tt></font> <br>
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>1d_nwk_M05_pits_001_P</tt></font> <font color="green"><tt> ! Defines pits </tt></font> <br>
<font color="blue"><tt>Pit Inlet Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\pit_dbase\pit_inlet_dbase.csv</tt></font> <font color="green"><tt> ! Pit inlet database defining depth-discharge curves </tt></font> <br>
<li>Save the ECF.
Line 96 ⟶ 113:
<li>Open the file '''M05_5m_001.tcf''' in a text editor and add the following line:<br>
<font color="blue"><tt>ESTRY Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M05_001.ecf</tt></font> <font color="green"><tt> ! Reference the ESTRY (1D) Control File </tt></font> <br>
<li>UpdateMake the following reference of the TGC and TBC files in the 'Model Inputs' sectionupdates:<br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M05_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\M05_001.tbc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Boundary Conditions Control File </tt></font> <br>
<font color="blue"><tt>BC Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\bc_dbase\bc_dbase_M05_001.csv </tt></font> <font color="green"><tt> ! Reference the Boundary Conditions Database </tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<font color="blue"><tt>Spatial Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\M05_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\M05_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\M05_001.tbc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Boundary Conditions Control File </tt></font> <br>
<li>Update the reference to the bc database:<br>
<font color="blue"><tt>BC Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\bc_dbase\bc_dbase_M05_001.csv </tt></font> <font color="green"><tt> ! Reference the Boundary Conditions Database </tt></font> <br>
<li>Save the TCF.
Line 109 ⟶ 131:
<li>Save a copy of '''_run_M02_HPC.bat''' as '''_run_M05_HPC.bat''' in the '''Module_05\TUFLOW\runs''' folder.
<li>Update the batch file to reference the '''M05_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>"..\..\..\exe\2023-03-AA2025.1.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>M05_5m_001.tcf </tt></font> <br>
Line 123 ⟶ 145:
= Check Files =
While the model is running, review the added features are specified correctly:
:*<u>[[Tutorial_M05_Check_Files_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M05_Check_Files_QGIS_GPKG | QGIS - GPKG]]</u>
<br>
 
Line 135 ⟶ 158:
:*Check files were used to review the connection between the pipe network and the 2D domain.
:*Results were viewed to assess the amount of water in the pipe network.
:*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>
:*Alternatively, see the <u>[[TUFLOW_Example_Models#Example_Model_Catalogue | TUFLOW Example Models]]</u> to explore the full list of TUFLOW features.
<br>
 
=1D Integrity Tool (Optional)=
The 1D Integrity Tool is a suite of tools designed to help modellers find and fix potential errors in 1D networks prior to running TUFLOW. It is a free tool that comes as part of the TUFLOW plugin:<br>
:*<u>[https://wiki.tuflow.com/index.php?title=1D_Integrity_Tool_-_Tutorial QGIS]
<br>
 
Retrieved from "https://wiki.tuflow.com/Tutorial_M05"