Tutorial Module08 Archive: Difference between revisions
Content deleted Content added
| (10 intermediate revisions by 5 users not shown) | |||
Line 16:
==Direct Rainfall==
This part of the tutorial will demonstrate how to apply direct rainfall to a model. We will also create a new boundary conditions database to reference the hyetograph. Follow the instructions below for your preferred GIS package.
* [[
* [[
* [[
==Depth Varying Roughness and Rainfall Losses==
Line 77:
=Run Simulation=
Using your preferred method for starting TUFLOW, run the newly created '''M08_5m_~s1~_001.tcf'''. Please refer to <u>[[
In this tutorial we are using a batch file to run simulations. The command line in our batch file will be similar to that used in Module 7:<br>
{| class="wikitable "
|-
|
<tt>set TUFLOWEXE_iSP
set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -
%RUN% -s1 EXG M08_5m_~s1~_001.tcf</tt>
|}
If the model fails to start correctly please refer to the <u>[[
''Tip: An example batch file called _ run all simulations.bat is included in the runs folder of the Complete_Model download dataset.'' <br>
Line 118 ⟶ 119:
<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>
<br>
As with all checks, warnings and errors, further information can be found on the [[
<ol>
Line 126 ⟶ 127:
So far we have been using the Single Precision version of TUFLOW for our simulations. This can be confirmed in the screenshot above of the _ TUFLOW Simulations.log file.<br>
The Double Precision version of TUFLOW is recommended for all direct rainfall models. <br>
The double precision version uses a great number of significant figures in it's calculations than the single precision version and is required for direct rainfall models due to the shallow depth of flow. At these shallow depths, more significant figures are needed to prevent mathematic rounding from producing mass error. For more information on single vs double precision, refer to this <u>[
<br>
Line 139 ⟶ 140:
|-
|
<tt>set TUFLOWEXE_iSP
set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -b
<font color="red">set RUN_iDP=start "TUFLOW" /wait "%TUFLOWEXE_iDP%" -b</font><br>
<font color="red">%RUN_iDP%</font> -s1 EXG <font color="red"> M08_5m_~s1~_002.tcf </font>
|}
<li> Save the .tcf and batch files and re-run the model.
Line 152 ⟶ 155:
=View the Results=
Open the 2D results in your preferred results viewer or import to your GIS package. For more information on how to do this, refer to <u>[
This module has applied the rainfall boundary to every active 2D cell. To aid visualisation of the results, an appropriate cut-off depth is typically used to only display the results above the specified depth. The depth chosen differentiates between shallow, sheet flow and depths classed as 'flooded'. The cut-off can be specified directly in the tcf or through post-processing of the results. 0.1m is commonly used as the cutoff depth value. The TCF command for TUFLOW to do this is:<br>
Line 161 ⟶ 164:
[[File:M08_D_max.PNG|400px]]
<br>
To post process the gridded results with a cut-off depth, the [
<br>
Visualising the velocity vectors in direct rainfall models provides a means to investigate flow paths and their behaviour. Note in the below image that a cut-off depth has been applied to the depth grid, but not the velocity vectors, thus the velocity and direction of shallow sheet flow can still be seen.<br>
Line 176 ⟶ 179:
In this optional section we will run the model using TUFLOW HPC (Heavily Parallelised Compute). TUFLOW HPC can run between 10 and 100 times faster than TUFLOW Classic using NVidia Graphics Processing Units (GPU)(depending on the model configuration and hardware performance). The speed of HPC makes it exceptionally well suited to high resolution direct rainfall urban applications. Large models with over 1,000,000 2D cells that take days to run using TUFLOW Classic can take hours to complete using TUFLOW HPC with high performance GPU hardware! The presentation "Rapid and Accurate Stormwater Drainage Assessments Using GPU Technology" highlights some performance test results comparing TUFLOW Classic against TUFLOW HPC for high resolution direct rainfall urban 1D/2D applications. A pdf copy of the presentation is available from the [https://www.tuflow.com/Download/Presentations/2017/Huxley2017_IECA-SQ%20Conference_Brisbane_pdf.pdf TUFLOW Library]<br><br>
''Note: If you have not previously used TUFLOW HPC, we recommend completing Tutorial Module 1, 2 and 3 before attempting this tutorial. The preceding tutorials include important lessons specific to using HPC, particularly its adaptive timestep / unconditional stability and GPU Hardware. Please see [[HPC_Features_Archive | HPC Features Archive]] for more information on TUFLOW HPC features supported in the 2017 release.<br><br>
In order to use the HPC solver, we will need to perform the following steps:
Line 207 ⟶ 210:
</ol>
<br>
''TIP: To switch on the HPC solver via scenario control commands, please see the <u>[[
:''Also, to learn how to optimise a HPC simulation to achieve the fastest simulation speed please complete <u>[[
=Conclusion=
Line 215 ⟶ 218:
=Troubleshooting=
If the TUFLOW simulation fails to start TUFLOW will output the error in a number of locations. Firstly, check the Console Window or the TUFLOW Log File (.tlf) (located in the '''TUFLOW\runs\log\''' folder). This file can be opened in a text editor and the error is generally located at the end of the file. You can however search for "Error" if you cannot see the error. In most cases there is also a spatial location for the error message (if the error reported in the log file is prefixed by XY:). To check the location of the geographic errors, open the '''_messages.mif''' or '''_messages_P.shp''' file in your GIS package.
This section contains links to some possible problems that may occur when progressing through the fourth tutorial module. If you experience an issue that is not detailed, please email
If you receive the following error when trying to run the TUFLOW HPC model using GPU hardware:
| |||