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.

13 Managing and Starting Simulations

  13.1 File Naming

  13.2 Simulation Management

    13.2.1 Events

      13.2.1.1 Event Groups

      13.2.1.2 Event Naming

      13.2.1.3 Simulating Events

      13.2.1.4 Event Examples

    13.2.2 Scenarios

      13.2.2.1 Scenario Naming

      13.2.2.2 Simulating Scenarios

      13.2.2.3 Scenario Examples

    13.2.3 Variables

      13.2.3.1 Variable Examples

  13.3 Installing TUFLOW

    13.3.1 Overview of the TUFLOW Distribution

      13.3.1.1 TUFLOW on Windows

      13.3.1.2 TUFLOW on Linux

      13.3.1.3 Build Identification

      13.3.1.4 System Library Files

    13.3.2 Single and Double Precision

      13.3.2.1 TUFLOW Classic

      13.3.2.2 TUFLOW HPC

    13.3.3 Customising TUFLOW using TUFLOW_USER_DEFINED.dll

    13.3.4 Installation Options

      13.3.4.1 Executable Download

      13.3.4.2 TUFLOW Installer

  13.4 Running Simulations

    13.4.1 Dongle Types and Setup

      13.4.1.1 Protocols for Accessing Dongles

        13.4.1.1.1 Licence Switching Options

      13.4.1.2 TUFLOW_Licence_Settings.lcf File

      13.4.1.3 Dongle Failure during a Simulation

    13.4.2 Starting a Simulation

      13.4.2.1 Script Examples and Run Options (Switches)

      13.4.2.2 Copy/Package Model from Script Files

      13.4.2.3 Advanced Script Files

      13.4.2.4 Running TUFLOW on Linux

    13.4.3 Running TUFLOW HPC

      13.4.3.1 TUFLOW HPC and GPU Module Commands

      13.4.3.2 Compatible Graphics Cards

      13.4.3.3 Updating NVIDIA Drivers

      13.4.3.4 NVLink – Multi-GPU Performance (HPC Only)

      13.4.3.5 Troubleshooting

    13.4.4 Running TUFLOW 1D Only Simulations

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

    13.5.1 Using TUFLOW with EPA SWMM

    13.5.2 Using TUFLOW with Flood Modeller

    13.5.3 Using TUFLOW with 12D

    13.5.4 Using TUFLOW with XP-SWMM

    13.5.5 Using TUFLOW with SMS

  13.6 Optimising Startup and Run Times

    13.6.1 Improved pre-processing of 1D Model Inputs

    13.6.2 Parallel Processing for SGS initialisation

    13.6.3 Optimising Multi-GPU Performance (HPC Only)

    13.6.4 Auto Terminate (Simulation End) Options

  13.7 Reproducibility of Results

    13.7.1 TUFLOW Classic (CPU only)

    13.7.2 TUFLOW HPC (incl. Quadtree) on CPU

    13.7.3 TUFLOW HPC (incl. Quadtree) on GPU

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