Example Models Home page

From Tuflow
Revision as of 13:07, 21 July 2016 by Chris Huxley (Talk | contribs) (Introduction)

Jump to: navigation, search


    The example models have been developed to demonstrate the most common TUFLOW model design features. These models use the tutorial datasets, and it is highly recommended that new users first familiarise themselves with the basics of TUFLOW through the tutorials rather than starting with these examples (Tutorial Models).

    Unlike the tutorials, which progressively increase the level of complexity with each Module, the models below are standalone examples, and can be used as a reference that demonstrates various TUFLOW features for more advanced users.
    The models have typically been developed from the most basic 2D model examples, and do not have step-by-step instructions as per the tutorial models.


    The requirements for these example models are as per the Tutorial modules, and can therefore be run without a TUFLOW license by using the .tcf command Tutorial Model == ON. TUFLOW build 2013-12-AE or later is required to simulate the models. TUFLOW has relatively modest system requirements for small models such as the tutorial model. However, larger and more complex models may have higher hardware requirements - in particular memory (RAM). TUFLOW is available in both 32 and 64 bit versions. For a full list of the Hardware and Software requirements, please refer to the Tutorial home page.

    Note: Currently the final 5 models, (EG09 and EG10) cannot be simulated license free as they require access to the Multiple 2D Domains and GPU modules respectively. Model 'EG00_2D_5m_002.tcf' (basic 2D model using US Customary Units) can only be simulated license free using the command Demo Model == ON and TUFLOW build 2016-03-AA or later.

    Example Model Data

    The model data is available for download from the TUFLOW website.

    The download dataset only include model input files to keep the file download to a manageable size. The models can be run using the batch file provided in the "runs" folder (Complete_Model\Tuflow\runs\_run_all.bat). Before using the batch file you will first need to update it using a text editor. You will need to reset the file path references to to the single and double precision TUFLOW executables (TUFLOW_iSP_w32.exe and TUFLOW_iDP_w32.exe). After updating the file path information, save the file then double click on the .bat file in Windows Explorer to initiate the simulations.

    Additional information on how to use and update batch files to execute multiple simulations is available here: Run TUFLOW From a Batch-file.

    Example Models

    Below is a complete list of the example models available for download from the TUFLOW website. The models are broken into 11 categories;

    • Basic 2D model: 2D models in metric and imperial units
    • Output options: 2D models with grid, point and region outputs
    • Boundary Condition Options: 1D and 2D models with various boundary condition types including water level, rainfall, 1D and stage boundaries
    • Topography Updates: Linear and spatial topography updates as well as embankment breaches through water level triggers
    • Loss Options: Various infiltration loss models
    • Scenario/Event Management: Models demonstrate use of scenarios and events for multiple model runs
    • Bridges: Bridge structures modelled in 1D and 2D
    • 1D/2D modelling: Pipe, river and culvert networks linked to 2D domain
    • 1D Operating Structures: Pump and sluice gate operational structures
    • 2D/2D Modelling: Various multiple 2D domain models
    • 2D GPU: 2D GPU modelling with stage-time and stage-discharge boundaries

    Reference to the Model Name and a Preceding Base Model are provided for comparison purposes. Compare the models against each other to identify the command syntax and input data differences, and hence the updates that are required to activate the feature referred to in the model description.

    Example Models
    Model Category Description Model Name Preceding Base model
    Basic 2D Model Write empty files EG00_Empty_5m_000.tcf N/A
    Basic 2D model (SI units - m) EG00_2D_5m_001.tcf EG00_Empty_5m_000.tcf
    Basic 2D model (USA units - ft) EG00_2D_5m_002.tcf EG00_2D_5m_001.tcf
    Output options 2D grid output EG01_2D_5m_001.tcf EG00_2D_5m_001.tcf
    2D point output EG01_2D_5m_002.tcf EG00_2D_5m_001.tcf
    2D region output EG01_2D_5m_003.tcf EG00_2D_5m_001.tcf
    Boundary Condition Options Stage discharge downstream boundary (2d_bc, HQ) EG02_2D_5m_001.tcf EG00_2D_5m_001.tcf
    Stage time downstream boundary (2d_bc, HT) EG02_2D_5m_002.tcf EG00_2D_5m_001.tcf
    Spatially varied initial water level commands (2d_iwl) EG02_2D_5m_003.tcf EG00_2D_5m_001.tcf
    Internal catchment rainfall (2d_sa) EG02_2D_5m_004.tcf EG00_2D_5m_001.tcf
    Internal catchment rainfall (2D_sa_rf) EG02_2D_5m_005.tcf EG00_2D_5m_001.tcf
    Direct rainfall (2D_rf) EG02_2D_5m_006.tcf EG00_2D_5m_001.tcf
    External and internal 1D boundaries (1d_bc) EG02_1D2D_5m_007.tcf EG07_1D2D_5m_002.tcf
    2D pump (2d_bc, SH) EG02_2D_5m_008.tcf EG00_2D_5m_001.tcf
    Topography Updates Thin breakline topography update (2d_zsh) EG03_2D_5m_001.tcf EG00_2D_5m_001.tcf
    Thick breakline topography update (2d_zsh) EG03_2D_5m_002.tcf EG00_2D_5m_001.tcf
    Gully breakline topography update (2d_zsh) EG03_2D_5m_003.tcf EG00_2D_5m_001.tcf
    Region topography update - No merge (2d_zsh) EG03_2D_5m_004.tcf EG00_2D_5m_001.tcf
    Region topography update - Merge (2d_zsh) EG03_2D_5m_005.tcf EG00_2D_5m_001.tcf
    Topography update - TIN (2d_zsh) EG03_2D_5m_006.tcf EG00_2D_5m_001.tcf
    Variable geometry (embankment breach) - Time trigger (2d_vzsh) EG03_2D_5m_007.tcf EG00_2D_5m_001.tcf
    Variable geometry (embankment breach) - Water level trigger (2d_vzsh) EG03_2D_5m_008.tcf EG00_2D_5m_001.tcf
    Variable geometry (embankment breach) - Water level difference trigger (2d_vzsh) EG03_2D_5m_009.tcf EG00_2D_5m_001.tcf
    Cell resolution change EG03_2D_2.5m_010.tcf EG00_2D_5m_001.tcf
    Loss Options Infiltration - IL/CL EG04_2D_5m_001.tcf EG00_2D_5m_001.tcf
    Infiltration - IL/CL EG04_2D_5m_002.tcf EG00_2D_5m_001.tcf
    Infiltration - IL/CL EG04_2D_5m_003.tcf EG00_2D_5m_001.tcf
    Infiltration - Green Ampt EG04_2D_5m_004.tcf EG00_2D_5m_001.tcf
    Infiltration - Green Ampt EG04_2D_5m_005.tcf EG00_2D_5m_001.tcf
    Infiltration - Green Ampt EG04_2D_5m_006.tcf EG00_2D_5m_001.tcf
    Infiltration - Horton EG04_2D_5m_007.tcf EG00_2D_5m_001.tcf
    Infiltration - Horton EG04_2D_5m_008.tcf EG00_2D_5m_001.tcf
    Infiltration - Horton EG04_2D_5m_009.tcf EG00_2D_5m_001.tcf
    Loss - IL/CL (Direct rainfall) EG04_2D_5m_010.tcf EG00_2D_5m_001.tcf
    Scenario/Event management Scenario (single) EG05_2D_5m_~s2~_002.tcf EG00_2D_5m_001.tcf
    Scenario (multiple) EG05_2D_~s1~_~s2~_002.tcf EG05_2D_~s1~_001.tcf
    Set Variable EG05_2D_~s1~_~s2~_003.tcf EG05_2D_~s1~_~s2~_002.tcf
    Event (single) EG05_2D_~e1~_004.tcf EG00_2D_5m_001.tcf
    Event (multiple) EG05_2D_~e1~_~e2~_005.tcf EG05_2D_~e1~_004.tcf
    Scenario (multiple), Event (multiple), Set Variable EG05_2D_~s1~_~s2~_~e1~_~e2~_006.tcf EG05_2D_~e1~_~e2~_005.tcf
    Bridges Bridge (2d_fc) EG06_2D_5m_001.tcf EG00_2D_5m_001.tcf
    Bridge (2d_fcsh) EG06_2D_5m_002.tcf EG00_2D_5m_001.tcf
    Bridge (2d_lfcsh) EG06_2D_5m_003.tcf EG00_2D_5m_001.tcf
    Bridge (1D) EG06_1D2D_5m_004.tcf EG00_2D_5m_001.tcf
    1D/2D Modelling 1D culverts: multidirectional and flap gated (1d_nwk) EG07_1D2D_5m_001.tcf EG02_2D_5m_004.tcf
    1D river (1d_nwk) EG07_1D2D_5m_002.tcf EG00_2D_5m_001.tcf
    1D pipe network (1d_nwk), inflow to pits (1D) EG07_1D2D_5m_003.tcf EG03_2D_5m_006.tcf
    1D pipe network (1d_nwk), direct rainfall inflow (2D) EG07_1D2D_5m_004.tcf EG03_2D_5m_006.tcf
    1D Operating Structures Operation controls: Pump (1d_nwk) EG08_1D2D_5m_001.tcf EG07_1D2D_5m_001.tcf
    Operation controls: Sluice Gate (1d_nwk) EG08_1D2D_5m_002.tcf EG07_1D2D_5m_002.tcf
    2D/2D Modelling 2D/2D model EG09_2D2D_001.tcf EG00_2D_5m_001.tcf
    2D/2D model (Domain boundary traversing an embankment) EG09_2D2D_002.tcf EG09_2D2D_001.tcf
    1D pipe network (1d_nwk), inflow to pits (1D) EG09_2D2D_003.tcf EG09_2D2D_001.tcf
    2D GPU 2D GPU with grid output, stage-discharge downstream boundary EG10_2D_5m_001.tcf EG01_2D_5m_001.tcf
    2D GPU with grid output, stage-time downstream boundary EG10_2D_5m_002.tcf EG10_2D_5m_001.tcf

    Recommended Reading

    • It is recommended that the TUFLOW manual be downloaded from the TUFLOW website.
    • It is also recommended that a sound naming convention for TUFLOW models and associated files be adopted. This is described in the following page: TUFLOW Naming Convention.
    • The following page (TUFLOW file types) describes the different file types and groups of files provided with this tutorial.
    • The use of a modelling log is also beneficial and highly recommended. TUFLOW modelling logs are discussed in this page: TUFLOW Modelling Log.