Difference between revisions of "Example Models Home page"

From Tuflow
Jump to: navigation, search
(Example Models)
(Introduction)
Line 1: Line 1:
 
<ol>
 
<ol>
 
= Introduction =
 
= Introduction =
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.<br>
+
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. (<u>[[Tutorial_Model |Tutorial Model Introduction]]</u>).<br><br>
 
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.<br>
 
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.<br>
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 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.
  
 
=Requirements=
 
=Requirements=

Revision as of 11:28, 21 July 2016

    Introduction

    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 Model Introduction).

    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.

    Requirements

    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.

    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.
    For a full list of the Hardware and Software requirements, please refer to the Tutorial home page.

    Example Model Data

    In order to build the models some additional data to the tutorial models is required. The background model data for the tutorial model is available for download on the TUFLOW website. The folder only contains the input files to keep the size of the download file manageable. The models can be downloaded in either MID/MIF or shape format.
    If you wish to run all of the final models for each module you can use the batch file under Complete_Model\Tuflow\runs\_run_all.bat. Before using the batch file you will firstly need to edit the file in a text editor and change the path to the executables (TUFLOW_iSP_w32.exe and TUFLOW_iDP_w32.exe), save then double click on the .bat file in Windows Explorer to initiate the simulations.
    In the results folder there is a batch file for processing the results of the final simulation for the module. This will process the results back into a GIS format for import into your selected GIS package. The model will have to be simulated before the results are processed!

    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


    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.