Tutorial M10: Difference between revisions

== GIS Inputs ==

Create, import and view input data:

 

== Simulation Control Files ==

<li>Save a copy of '''M02_001.tgc''' as '''M10_001.tgc''' in the '''Module_10\TUFLOW\model''' folder. <br>

<li>Open the '''M10_001.tgc''' in a text editor.

<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M10_damwall_001_L.shp </tt></font><font color="green"><tt> ! Creates dam embankment</tt></font><br>

<li>Save the TGC.

</ol>

<li>Open the '''M10_001.tbc''' in a text editor.

<li>Update the reference to the 2D boundaries:<br>

<li>Include a reference to the new 2D source area boundary:<br>

<font color="blue"><tt>Read GIS SA </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_sa_M10_inflow_001_R.shp </tt></font> <font color="green"><tt> ! Reads in 2D source area boundaries</tt></font> <br>

<li>Save the TBC.

</ol>

<ol>

<li>Save a copy of '''M02_5m_001.tcf''' as '''M10_5m_001.tcf''' in the '''Module_10\TUFLOW\runs''' folder.

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

<li>An Initial Water Level command is required. Include the following command after the 'Model Inputs' section: <br>

<font color="green"><tt>! INITIAL WATER LEVEL</tt></font><br>

<font color="blue"><tt>Read GIS IWL </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\2d_iwl_M10_001_R.shp </tt></font> <font color="green"><tt> ! Reads in initial water level</tt></font> <br>

<li>Add bathymetry (ZH) as additional Map Output Data Type:<br>

<font color="blue"><tt>Map Output Data Types </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> h V d dt ZH </tt></font> <font color="green"><tt> ! Outputs water levels, velocities, depths, minimum timestep, bathymetry</tt></font> <br>

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

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

== 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>Open the '''M10_002.tgc''' in a text editor.

<li>Update the reference to the Variable Z Shape:<br>

<li>Save the TGC.

</ol>

<ol>

<li>Save a copy of '''M10_5m_001.tcf''' as '''M10_5m_002.tcf''' in the '''Module_10\TUFLOW\runs''' folder.

<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M10_002.tgc </tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font> <br>

<li>Save the TCF.

<li>Open '''_run_M10_HPC.bat''' in a text editor from the '''Module_10\TUFLOW\runs''' folder.

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

== 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 ==

*Pipe Failure control commands contained within the '<font color="blue"><tt>Define Pipe Failure Control</tt></font> <font color="red"><tt> ==</tt></font> <font color="black"><tt> PF01</tt></font>' logic block:

:*The piping failure is triggered when the water level at the upstream node of the 1d_nwk PF01 line is greater than 59.5m.

:*The default shape of the piping failure is rectangular.

:*The discharge coefficient (Cd) is set to 0.6.

:*An initial collapse to a depth of 3m occurs within 60 seconds.

:*Following the initial collapse the dam fails in a trapezoidal shape, with a side slope of 60 degrees, to a depth of 20 metres and a top width fully breached of 25 metres over a period of 0.5 hours. The top width fully breached can be set smaller than the 'Width_or_Dia' attribute if the maximum breach width does not reach the total width of the dam crest. <br>

 

===TUFLOW Estry Control File (ECF) ===

<li>Create a new text file '''M10_003.ecf''' in the '''Module_10\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 DAMBREAK</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_M10_dambreak_003_L.shp</tt></font> <font color="green"><tt>! Defines 1D dambreak</tt></font><br>

 

<li>Save the ECF. <br>

<li>Open the '''M10_003.tgc''' in a text editor.

<li>Comment out or delete the reference to the Variable Z Shape, the dam failure is controlled within the ECF and TOC files:<br>

<li>Save the TGC.

</ol>

<li>Open the '''M10_003.tbc''' in a text editor.

<li>Include a reference to the new 1D/2D boundary:<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_M10_piping_dambreak_003_L.shp </tt></font> <font color="green"><tt> ! Links the 1D piping and dambreak to the 2D domain</tt></font> <br>

<li>Save the TBC.

</ol>

<li>Open the '''M10_5m_003.tcf''' in a text editor.

<li>Include a reference of the ECF in the 'Model Inputs' section: <br>

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

<li>Save the TCF.

<li>Open '''_run_M10_HPC.bat''' in a text editor from the '''Module_10\TUFLOW\runs''' folder.

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

== Troubleshooting ==

See tips on common mistakes and troubleshooting steps if the model doesn't run:

 

== Check Files ==

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

Review the 1D output file:

<ol>

== GIS Inputs ==

Create, import and view input data:

 

== Simulation Control Files ==

<li>Open the '''M10_004.tgc''' in a text editor.

<li>Comment out or delete the reference to the Variable Z Shape:<br>

<li>Save the TGC.

</ol>

===TUFLOW Boundary Control File (TBC) ===

<ol>

<li>Open the '''M10_004.tbc''' in a text editor.

<li>Comment out or delete the reference to the upstream 2d_sa inflow and internal 2d_sa inflows representing the four flows on the internal catchments, the module is simulating flow from the dam break only:<br>

<font color="green"><tt>! Read GIS SA == gis\2d_sa_M10_inflow_001_R.shp </tt></font><br>

<li>Include a reference to the new 2D source area boundary representing the flow from the dam break:<br>

<font color="blue"><tt>Read GIS SA </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_sa_M10_dambreak_004_R.shp </tt></font> <font color="green"><tt> ! Reads in 2D source area boundaries</tt></font> <br>

<li>Save the TBC.

</ol>

<ol>

<li>Save a copy of '''M10_5m_001.tcf''' as '''M10_5m_004.tcf''' in the '''Module_10\TUFLOW\runs''' folder.

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

<li>Comment out or delete the reference to the Initial Water Level:<br>

<li>Save the TCF.

</ol>

<li>Open '''_run_M10_HPC.bat''' in a text editor from the '''Module_10\TUFLOW\runs''' folder.

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

== Check Files ==

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

 

== Results==

TUFLOW supports the modelling of Non-Newtonian fluids. It is a fluid that does not follow Newton's law of viscosity (i.e. constant viscosity independent of stress). The viscosity can change when under force to behave either more liquid or more solid. This can occur in a dam break due to the sediment contained within the dam. <br>

 

 

'''Part 5 builds from the model created in <u>[[Tutorial_M10#Part_4_-_Boundary_Condition_Breach_Hydrograph | Part 4]].</u>'''

<li>Open '''_run_M10_HPC.bat''' in a text editor from the '''Module_10\TUFLOW\runs''' folder.

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

<li>Search for 'Viscosity Formulation' and review the input values:<br>

<br>

</ol>

 

:*TUFLOW log files and GIS layers were used to check the dam break was modelled correctly.

:*New bathymetry map output and 1D operational structure time series data were inspected.

<br>