Tuflow

HPC Running and Converting Models: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(10 intermediate revisions by 5 users not shown)
Line 1:
= Introduction =
This page contains information about converting an existing TUFLOW Classic or GPU (pre 2017 HPC release) model to a format that can be run using the TUFLOW HPC engine. This page provides a quick summary for experienced TUFLOW users to use as a reference point for updating their models. It is recommended that less experienced TUFLOW users refer to our <u>[[Tutorial_ModelTutorial_Introduction |TUFLOW Tutorial Modules]]</u> for greater support and guidance on creating a HPC model.<br>
 
To convert an existing TUFLOW Classic or GPU Model to run on HPC, an update to the TUFLOW Control File (TCF) is needed. Some features from TUFLOW Classic that are not currently supported in HPC, may prevent the HPC model running successfully. To find out more about unsupported features in HPC, be surerefer to review the <u>[https://docs.tuflow.com/Downloadclassic-hpc/TUFLOWmanual/Releaseslatest/2017-09/TUFLOW%20Release%20Notes.2017-09.pdf TUFLOW 2017-09 Release NotesManual]</u>. or the <u>[[HPC Features | HPC Features Wiki Page]]</u>.<br>
 
= Converting TUFLOW Classic to HPC (TCF Updates) =
Line 19:
= Running HPC on Multiple GPU Devices =
Much like HPC can be run across multiple CPU processors, HPC can be run across multiple GPU cards. Models can also be instructed to run on a specific GPU card.<br>
If a machine only has a single GPU card, the GPU Device ID should be 0, this is a default. If a second GPU card was added, the Device ID would be 1 and so on. The GPU IDs can be checked by reviewing the machines ''Device Manager''. Note that the order may not match the expectations, see <u>[[Configure CUDA device selection]]</u> for more information. <br>
The most common method is to specify the GPU card ID in the batch file / command line by using the -pu<id> argument.<br>
Example below will run single simulation across the first and second GPU card (ID 0 and 1).
<pre>"TUFLOW_iSP_w64.exe" -pu0 -pu1 "M01_5m_001.tcf"</pre>
Line 52:
If using the above Scenario Logic, the modeller must include a scenario call in the batch file.<br>
<font color="blue"><tt>-s1 <Hardware Type> </tt></font><br>
If you are unfamiliar with using Scenario Logic, please refer to <u>[[Tutorial_Module05Tutorial_M08 |Tutorial Module 0508]]</u>.<br>
 
Other useful batch file switches include:<br>
<font color="blue"><tt>-nt <number_of_threads> </tt></font>: This switch is used to set the number of CPU threads used for CPU mode simulations.<br>
<font color="blue"><tt>-pu <GPU Device IDs> </tt></font>: This switch is used to selectset the number of GPU cardsdevices thatand TUFLOWwhich usesdevices to use.<br>
 
An example of how this would be implemented into a simple batch file for CPU and GPU are shown below.<br>
 
Line 68 ⟶ 67:
This example will run TUFLOW HPC on GPU using 2 GPU cards.<br>
<br>
<br>
{{Tips Navigation
|uplink=[[ HPC_Modelling_Guidance | Back to HPC Modelling Guidance]]
}}
Retrieved from "https://wiki.tuflow.com/HPC_Running_and_Converting_Models"