Tuflow

Tutorial Module01 Archive: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
No edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 68:
 
=== Set GIS Projection and Create Empty (Template) GIS Files ===
The first step when creating a TUFLOW model always requires the user to define the GIS projection (iei.e. the geographic coordinate system to be used for the TUFLOW model) and also write template GIS files for future model inputs.<br>
''Note: All model inputs will need to use a common projection.''
 
Line 120:
<br>
<li> Start TUFLOW from a batch file using the TCF file we have created ('''M01_5m_001.tcf'''). Follow the steps outlined in, <u>[[Run TUFLOW From a Batch-file | Running TUFLOW from a Batch-file]]</u> to create the batch file.
<li> Double click the created batch file (.bat) from Windows Explorer to execute the simulation. A console (DOS) window should appear as shown below:<br>
[[File:Tute M01 DOS Empties.png|frame|none]]
<br>
Line 217:
<br>
=== Define the Materials (Surface Roughness) ===
Surface roughness or bed resistance values (ege.g. Manning’s n) are assigned to Materials values. The '''Module_Data\Module_01\''' folder already contains the materials table that we’ll use. We will review these in a GIS package, please select one of:
 
* <u>[[Tute_M01_Materials_MI_Archive|Mapinfo]]</u>
Line 334:
== TUFLOW Simulation Control File (TCF) Updates ==
=== Set Model Controls ===
This is the last step before running the simulation. Once this step has been completed, most of the ground workgroundwork has been completed. Subsequent modules build upon this base.
 
<ol>
Line 342:
:<font color="blue"><tt>End Time </tt></font> <font color="red"><tt>==</tt></font><tt> 3</tt><font color="green"><tt> ! End Simulation a 3 hours</tt></font><br>
:<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>==</tt></font><tt> 1.5</tt><font color="green"><tt> ! Use a 2D timestep of 1.5 seconds</tt></font><br>
:<font color="blue"><tt>Log Folder </tt></font> <font color="red"><tt>==</tt></font><tt> Log</tt><font color="green"><tt> ! Redirects log output (ege.g. .tlf and _messages GIS layers to the folder "log"</tt></font>
:<font color="blue"><tt>Output Folder </tt></font> <font color="red"><tt>==</tt></font><tt> ..\results\M01\2d\</tt><font color="green"><tt> ! Redirects results files to TUFLOW\Results\M01\2d\</tt></font>
:<font color="blue"><tt>Write Check Files </tt></font> <font color="red"><tt>==</tt></font><tt> ..\check\2d\</tt><font color="green"><tt> ! Specifies check files to be witten to TUFLOW\check\2d\</tt></font>
Line 351:
You do <u>not</u> need to add the comments, following the exclamation marks. These commands are generally self explanatory. However, for this tutorial model they are included. To clarify the purpose of each line.<br>
The final command "Map Output Format" controls the output file format, this is discussed further in the results viewing section below.<br>
The TUFLOW simulation is now ready to be run for the first time.
</ol>
 
Line 409:
 
=== TUFLOW Log file ===
The first place to look is at the final output in the DOSconsole window. If you missed this, for example if the model was run in batch mode this information is contained in the TUFLOW Log File (.tlf). Earlier on we add the following command to the TCF:<br>
<font color="blue"><tt>Log Folder </tt></font> <font color="red"><tt>==</tt></font> <tt>Log</tt><br>
 
Line 463:
 
=== TUFLOW Messages Layers ===
TUFLOW writes a number of messages, in increasing order of severity these are: Check --> Warning --> Error. Each of the messages generated by TUFLOW has a four digit ID code. A description of each of these messages is given in the message database section of this wiki: <u>[[TUFLOW_Message_How_ToTUFLOW_Messages | (TUFLOW Messages Database)]]</u>.
When a numerical model such as TUFLOW struggles to converge to a solution, spurious results such as negative depths can be generated. When this occurs TUFLOW creates a warning and writes this to the _messages.csv file and also to a GIS file. This can be opened in excel, or your GIS package.
<ol>
Line 507:
 
==Troubleshooting==
This section contains links to some common issues that may occur when progressing through the first module of the TUFLOW tutorial model. If you experience an issue that is not detailed on here please either send an email to [mailto:support@tuflow.com support@tuflow.com].<br>
 
*<u>[[Save_Date_Error_Archive|Save date of .tab file is later than .mif or .mid]]</u><br>
*<u>[[Tutorial_Troubleshoot_2014|ERROR 2014 - No active cells within SA inflow polygon]]</u>
*<u>[[Only_TUFLOW_DOS_Window_ArchiveOnly_TUFLOW_Console_Window_Archive | Why does the TUFLOW DOSconsole Windowwindow open, though the TCF isn’t read and the simulation doesn’t execute?]]</u>
 
== Advanced - Model Resolution (Optional) ==
Line 559:
 
== Advanced - HPC Solver (Optional) ==
This section will introduce how to run the model TUFLOW’s HPC (Heavily Parallelised Compute) solver, and how to fix some common issues that may occur when trying to run a simulation using Graphics Processing Unit (GPU) hardware. Please see [[HPC_Features_Archive | HPC Features Archive]] for more information on TUFLOW HPC features supported in the 2017 release.
 
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). <br><br>
Line 582:
===Results===
Using the methods described above in the <u>[[Tutorial_Module01_Archive#Viewing_Results | Viewing Results]]</u> section.
* Check the simulation logs in the DOSconsole window, .tlf and .hpc.tlf log files.
* View the results in your preferred package.
Do the logs and results appear different? Did the simulation run faster using the GPU hardware? For more information about computer hardware and simulation speed, please refer to the <u>[[Hardware_Benchmarking | Hardware Benchmarking Page]]</u>.
Line 601:
</ol>
<br>
If you experience an issue that is not detailed above please send an email to [mailto:support@tuflow.com support@tuflow.com]<br>
Retrieved from "https://wiki.tuflow.com/Tutorial_Module01_Archive"