Tutorial M11: Difference between revisions

<ol><ol><li>1d_wll: A layer used to define 1D water level lines (to display 1D results in 2D map outputs). </ol></ol>

:*TBC layers:

 

'''Module 11 builds from the model created in <u>[[Tutorial_M02 | Module 2]]</u>. The completed Module 2 model is provided in the Module_11\TUFLOW folder.''' <br>

<br>

== GIS Inputs ==

Create, import and view input data:

 

== Boundary Condition Database (bc_dbase) ==

<li>Create a new text file '''M11_001.ecf''' and save it in the '''Module_11\TUFLOW\model''' folder.

<li>Add the following command lines: <br>

<font color="green"><tt>! 1D TIME CONTROL</tt></font> <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="green"><tt>! 1D WATER LEVEL LINES</tt></font> <br>

<font color="blue"><tt>Read GIS WLL </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_wll_M11_001_L.shp</tt></font> <font color="green"><tt> ! Displays 1D results in 2D map output result files</tt></font> <br>

<li>Save the ECF. <br>

</ol>

<li>Save a copy of the '''M02_001.tgc''' as '''M11_001.tgc''' in the '''Module_11\TUFLOW\model''' folder.

<li>Open the '''M11_001.tgc''' in a text editor and add the following line after the 'Read GIS Code' command: <br>

<font color="blue"><tt>Read GIS Code</tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_code_M11_null_creek_001_R.shp</tt></font> <font color="green"><tt> ! Deactivates cells where the channel has been modelled in 1D</tt></font> <br>

<li>Add the following line after the 'Read GIS Z Shape' command: <br>

<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M11_hx_001_L.shp | gis\2d_zsh_M11_hx_001_P.shp</tt></font> <font color="green"><tt> ! Defines the bank crest levels</tt></font> <br>

<li>Save the TGC.

</ol>

<li>Save a copy of the '''M01_001.tbc''' as '''M11_001.tbc''' in the '''Module_11\TUFLOW\model''' folder.

<li>Open the '''M11_001.tbc''' in a text editor and comment out or delete the below line, 1D boundaries are used instead: <br>

<font color="green"><tt>! Read GIS BC == gis\2d_bc_M01_001_L.shp ! Reads in 2D boundaries</tt></font> <br>

<li>Add reference to the new boundaries at the end of the TBC: <br>

<font color="green"><tt>! INTERNAL 1D/2D BOUNDARIES</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_M03_culverts_001_P.shp</tt></font> <font color="green"><tt> ! Links 1D culverts to 2D domain</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_M11_hx_001_L.shp</tt></font> <font color="green"><tt> ! Reads in HX boundaries linking 1D channel to 2D domain</tt></font> <br>

<li>Save the TBC.

</ol>

<li>Open the '''M11_5m_001.tcf''' in a text editor and add the following line in the 'Model Inputs' section: <br>

<font color="blue"><tt>ESTRY Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> ..\model\M11_001.ecf </tt></font> <font color="green"><tt> ! Reference the ESTRY (1D) Control File</tt></font> <br>

<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M11_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\M11_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_M11_001.csv</tt></font> <font color="green"><tt> ! Reference the Boundary Conditions Database</tt></font> <br>

<li>Remove reference to the 2D plot outputs and replace with reference to the reporting locations: <br>

<font color="green"><tt>! Read GIS PO == ..\model\gis\2d_po_M01_001_L.shp ! Reads in plot output line</tt></font> <br>

<font color="green"><tt>! Read GIS PO == ..\model\gis\2d_po_M01_001_P.shp ! Reads in plot output point</tt></font> <br>

<font color="blue"><tt>Read GIS Reporting Location </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\0d_rl_M11_001_L.shp</tt></font> <font color="green"><tt> ! Reads in reporting location line</tt></font> <br>

<font color="blue"><tt>Read GIS Reporting Location </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\0d_rl_M11_001_P.shp</tt></font> <font color="green"><tt> ! Reads in reporting location point</tt></font> <br>

<li>Save the TCF.

</ol>

<li>Save a copy of '''_run_M02_HPC.bat''' as '''_run_M11_HPC.bat''' in the '''Module_11\TUFLOW\runs''' folder.

<li>Update the batch file to reference the '''M11_5m_001.tcf''' :<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>M11_5m_001.tcf </tt></font> <br>

<li>Double click the batch file in file explorer to run the simulation. <br>

</ol>

 

== Check Files ==

While the model is running, review the added features are specified correctly:

 

== Results ==

== GIS Inputs ==

Create, import and view input data:

 

== Simulation Control Files ==

<li>Save a copy of the '''M11_001.ecf''' as '''M11_002.ecf''' in the '''Module_11\TUFLOW\model''' folder.

<li>Open the '''M11_002.ecf''' in a text editor and update the following reference: <br>

<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_M11_culverts_002_L.shp</tt></font> <font color="green"><tt> ! Defines culverts</tt></font> <br>

<li>Add the following commands:<br>

<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_M11_bridges_002_L.shp</tt></font> <font color="green"><tt> ! Defines bridges</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_M11_weirs_002_L.shp</tt></font> <font color="green"><tt> ! Defines weirs</tt></font> <br>

<font color="blue"><tt>Read GIS Table Links </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>xs\1d_xs_M11_bridges_002_L.shp</tt></font> <font color="green"><tt> ! References bridges cross section data stored in separate csv</tt></font> <br>

<font color="blue"><tt>Read GIS Table Links </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>xs\1d_xs_M11_weirs_002_L.shp</tt></font> <font color="green"><tt> ! References weirs cross section data stored in separate csv</tt></font> <br>

<li>Save the ECF.

</ol>

<li>Save a copy of the '''M11_001.tgc''' as '''M11_002.tgc''' in the '''Module_11\TUFLOW\model''' folder.

<li>Open the '''M11_002.tgc''' in a text editor and update the following references: <br>

<font color="blue"><tt>Read GIS Code </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_code_M11_null_creek_002_R.shp</tt></font> <font color="green"><tt> ! Deactivates cells where the channel has been modelled in 1D </tt></font> <br>

<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M11_hx_002_L.shp | gis\2d_zsh_M11_hx_001_P.shp</tt></font> <font color="green"><tt> ! Defines the bank crest levels</tt></font> <br>

<li>Save the TGC.

</ol>

<ol>

<li>Save a copy of the '''M11_001.tbc''' as '''M11_002.tbc''' in the '''Module_11\TUFLOW\model''' folder.

<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_M11_hx_002_L.shp</tt></font> <font color="green"><tt> ! Reads in HX boundaries linking 1D channel to 2D domain</tt></font> <br>

<li>Save the TBC.

</ol>

<ol>

<li>Save a copy of the '''M11_5m_001.tcf''' as '''M11_5m_002.tcf''' in the '''Module_11\TUFLOW\runs''' folder.

<font color="blue"><tt>ESTRY Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> ..\model\M11_002.ecf </tt></font> <font color="green"><tt> ! Reference the ESTRY (1D) Control File</tt></font> <br>

<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M11_002.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\M11_002.tbc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Boundary Conditions Control File</tt></font> <br>

<li>Save the TCF.

== Running the Simulation ==

Update the batch file created in the first part of Module 11 to reference the '''M11_5m_002.tcf''' file. Save the batch file and double click it in file explorer to run the simulation. <br>

 

== Check Files ==

While the model is running, review the added features are specified correctly:

 

== Results ==

:*A model with 1D open channel embedded into 2D floodplain was created.

:*The 1D open channel conveyed flow underneath the roads through 1D culverts.

 

<br>