Section 13 Managing and Starting Simulations

This chapter provides guidance on model naming conventions and how TUFLOW’s powerful Variables, Events and Scenarios functionalities may be used to simulate any number of scenarios and events from a single control (.tcf) file.

The latter part of the chapter discusses the installation of TUFLOW, the different TUFLOW dongle types and how to start a simulation, both as a standalone TUFLOW simulation and in conjunction with third-party software.

Finally, there is a section on the reproducibility of results when using different hardware.

13Managing and Starting Simulations

  13.1File Naming

  13.2Simulation Management

    13.2.1Events

      13.2.1.1Event Groups

      13.2.1.2Event Naming

      13.2.1.3Simulating Events

      13.2.1.4Event Examples

    13.2.2Scenarios

      13.2.2.1Scenario Naming

      13.2.2.2Simulating Scenarios

      13.2.2.3Scenario Examples

    13.2.3Variables

      13.2.3.1Variable Examples

  13.3Installing TUFLOW

    13.3.1Overview of the TUFLOW Distribution

      13.3.1.1TUFLOW on Windows

      13.3.1.2TUFLOW on Linux

      13.3.1.3Build Identification

      13.3.1.4System Library Files

    13.3.2Single and Double Precision

      13.3.2.1TUFLOW Classic

      13.3.2.2TUFLOW HPC

    13.3.3Customising TUFLOW using TUFLOW_USER_DEFINED.dll

    13.3.4Installation Options

      13.3.4.1Executable Download

      13.3.4.2TUFLOW Installer

  13.4Running Simulations

    13.4.1Dongle Types and Setup

      13.4.1.1Protocols for Accessing Dongles

        13.4.1.1.1Licence Switching Options

      13.4.1.2TUFLOW_Licence_Settings.lcf File

      13.4.1.3Dongle Failure during a Simulation

    13.4.2Starting a Simulation

      13.4.2.1Script Examples and Run Options (Switches)

      13.4.2.2Copy/Package Model from Script Files

      13.4.2.3Advanced Script Files

      13.4.2.4Running TUFLOW on Linux

    13.4.3Running TUFLOW HPC

      13.4.3.1TUFLOW HPC and GPU Module Commands

      13.4.3.2Compatible Graphics Cards

      13.4.3.3Updating NVIDIA Drivers

      13.4.3.4NVLink – Multi-GPU Performance (HPC Only)

      13.4.3.5Troubleshooting

    13.4.4Running TUFLOW 1D Only Simulations

  13.5Using TUFLOW with Flood Modeller, SWMM, XP-SWMM, 12D or from SMS

    13.5.1Using TUFLOW with EPA SWMM

    13.5.2Using TUFLOW with Flood Modeller

    13.5.3Using TUFLOW with 12D

    13.5.4Using TUFLOW with XP-SWMM

    13.5.5Using TUFLOW with SMS

  13.6Optimising Startup and Run Times

    13.6.1Improved pre-processing of 1D Model Inputs

    13.6.2Parallel Processing for SGS initialisation

    13.6.3Optimising Multi-GPU Performance (HPC Only)

    13.6.4Auto Terminate (Simulation End) Options

  13.7Reproducibility of Results

    13.7.1TUFLOW Classic (CPU only)

    13.7.2TUFLOW HPC (incl. Quadtree) on CPU

    13.7.3TUFLOW HPC (incl. Quadtree) on GPU

    13.7.4TUFLOW HPC (incl. Quadtree) on multiple GPUs / CPU threads