Flood Modeller Tutorial Module02 Provisional

From Tuflow
Jump to navigation Jump to search

Introduction

In this tutorial we will add a representation of a proposed development which involves adding TUFLOW 1D pipe network elements into the existing model network to represent the drainage network, which will then be linked with Flood Modeller Pro.
This will involve:

  • Modification of the floodplain topography by the creation of a 3D TIN surface;
  • Revising the land use;
  • The addition of pipes and pits to represent an underground drainage network in ESTRY;
  • Linking the pipe network in ESTRY to Flood Modeller network;
  • The addition of an inflow into the pipe network; and,
  • The addition of a river reach represented in ESTRY downstream of the Flood Modeller network.

GIS and Model Inputs

The steps necessary to modify each of the GIS inputs are demonstrated in QGIS using SHP and GPKG formats. If you would like to view instructions for the tutorial in ArcGIS or MapInfo these can be found on the archive page for Tutorial Module 02.

Define Elevations (Building a TIN)

We have provided the GIS layers necessary to modify the ground elevations to represent the proposed development. This part of the tutorial will demonstrate how a TIN is created from these GIS layers. We will also update the GIS defining the road crest level. Follow the instructions below for your preferred GIS format.

Define Surface Roughness

We have provided the GIS layers necessary to modify the land use areas that will change as part of the proposed development. This part of the tutorial will require populating the layer attributes to assign Manning’s n roughness values to each land use. Follow the instructions below for your preferred GIS format.

Define Pipe Network

This part of the module creates the GIS layers that make up a pipe network. The pits of the pipe network will be linked to the 2D domain. We will also create the pit inlet database which links the GIS layers to depth-discharge curves. Follow the instructions below for your preferred GIS format.

Define Boundary Conditions

This part of the module demonstrates how an inflow can be applied directly to the pits of the pipe network. A GIS layer of the inflow boundary has been provided. We will also modify the existing Boundary Conditions Database to include these new inflows. Follow the instructions below for your preferred GIS format.

Flood Modeller 1D/ESTRY 1D Link

This part of the module demonstrates how TUFLOW 1D (ESTRY) domains can be dynamically linked with Flood Modeller using "X1DH" and "X1DQ" links. Follow the instructions below for your preferred GIS format.

The main driver for this feature is for Flood Modeller - TUFLOW models to utilise the powerful pipe network and manhole modelling capabilities of TUFLOW (see the TUFLOW Manual for more details) and be able to link these networks into a Flood Modeller river model.

Flood Modeller and TUFLOW (ESTRY) nodes will be considered linked if an ESTRY node in a 1d_nwk layer, and a Flood Modeller node in a Read GIS X1D Nodes or Read GIS X1D Network layer are snapped together, or are within the snap tolerance distance specified.

ESTRY nodes are automatically generated at the upstream and downstream extremities of an ESTRY link so manually generating a mode is not mandatory. If no node is manually added, then the Flood Modeller-ESTRY link is assumed to be a “X1DH” link. If an ESTRY is manually generated, then the ESTRY node can have a 1d_nwk layer Conn_1D_2D attribute of either “X1DH” or “X1DQ”.

  • An "X1DH" link means a Flood Modeller 1D water level is being applied at the ESTRY node (ie. Flood Modeller sends ESTRY a water level and ESTRY sends back a +/- flow to Flood Modeller). An ESTRY X1DH (the default) would be used for most Flood Modeller ESTRY links.
  • An "X1DQ" link means a Flood Modeller inflow/outflow is being applied at the ESTRY node (ie. Flood Modeller sends ESTRY a +/- flow and ESTRY sends back a water level).

    • Modify Simulation Control Files

    Now that we have made all of the necessary changes to the GIS layers, we need to update our control files to include all the changes representing the proposed development.

    TUFLOW Geometry Control File

    There have been two changes to the model that impact the TGC file:

    • We have created two layers that together form a 3D TIN representing changes to the ground elevations.
    • We have created two 2d_mat layers that represent changes to the land use at the location of the proposed development.
    1. Begin by opening FMT_M01_001.tgc in your text editor. Save the file as FMT_M02_001.tgc.
    2. Open FMT_M02_001.tgc
    3. We will now add the commands to modify the topography to represent the proposed development. Add the following commands after the READ GIS Z Shape line:

      4. QGIS - SHP

      Create TIN Zpts WRITE TIN == gis\2d_ztin_FMT_M02_development_001_R.shp | gis\2d_ztin_ FMT_M02_development_001_P.SHP

      QGIS - GPKG

      Create TIN Zpts WRITE TIN == 2d_ztin_FMT_M02_development_001_R | 2d_ztin_ FMT_M02_development_001_P

      The Create TIN Zpts Write TIN command creates and writes an SMS .tin file to the same location as the GIS layer (in this case the TUFLOW\model\gis folder). The TIN can be viewed, checked and modified in SMS. This can then be read into the model directly using the Read TIN zpts command for any subsequent model simulations.

      Our intention for the 2d_mat layers created in this module is for them to build upon the existing commands which modify roughness. We would like for the new layers to overwrite the existing layers at the location of the proposed development. This process of layering and building up the model is a powerful tool in TUFLOW that minimises data duplication and provides a means of quality control. We need to ensure that the commands reading in our new 2d_mat layers are read in after the existing commands.

      QGIS - SHP

      Read GIS Mat== gis\2d_mat_FMT_M02_DEV_001_R.SHP font color="blue">Read GIS Mat== gis\2d_mat_FMT_M02_DEV_Buildings_001_R.SHP

      QGIS - GPKG

      Read GIS Mat== 2d_mat_FMT_M02_DEV_001_R Read GIS Mat== 2d_mat_FMT_M02_DEV_Buildings_001_R

    4. Save the file. The .tgc file is now ready to be used.

    ESTRY Control File

    There have been three changes to the model that impact the ECF file:

    • We have created a 1d_nwk layer representing the culverts of the proposed pipe network
    • We have created a 1d_nwk layer representing the pits of the proposed pipe network
    • We have created a pit inlet database that links depth-discharge curves to the pit inlet type.
    1. Open FMT_M01_001.ecf in your text editor. Save the file as FMT_M02_001.ecf.
    2. Open FMT_M02_001.ecf
    3. Add the following commands at the bottom of the file as follows:
      QGIS - SHP
      Read GIS Network == gis\1d_nwk_FMT_M02_Pipes_001_L.SHP
      Read GIS Network == gis\1d_nwk_FMT_M02_Pits_001_P.SHP
      Pit Inlet Database == ..\pit_dbase\pit_inlet_dbase.csv
      Read GIS Network == gis\1d_nwk_FMT_M02_Channels_001_L.SHP
      Read GIS Network == xs\1d_xs_FMT_M02_Creek_001_L.SHP
      Read GIS Network == gis\1d_nwke_X1DQ_P.shp
      Read GIS BC == gis\1d_BC_FMT_M02_001_P.shp

      QGIS - GPKG
      Read GIS Network == 1d_nwk_FMT_M02_Pipes_001_L
      Read GIS Network == 1d_nwk_FMT_M02_Pits_001_P
      Pit Inlet Database == ..\pit_dbase\pit_inlet_dbase.csv
      Read GIS Network == 1d_nwk_FMT_M02_Channels_001_L
      Read GIS Network == 1d_xs_FMT_M02_Creek_001_L
      Read GIS Network == 1d_nwke_X1DQ_P
      Read GIS BC == 1d_BC_FMT_M02_001_P
    4. Save the file. The 1D control file is now ready to be used.

    TUFLOW Boundary Condition File

    There has been one change to the model that impacts the TBC file:

    • We have created a 2d_sa layer to define inflows into the pipe network.
    1. Open FMT_M01_001.tbc in your text editor and save as FMT_M02_001.tbc
    2. Insert the following commands after the existing Read GIS SA == mi\2d_sa_M01_002_R.MIF command:

      3. QGIS - SHP
    3. Insert the following commands after the existing Read GIS SA == mi\2d_sa_M01_002_R.MIF command:
      Read GIS SA PITS == gis\2d_sa_FMT_M02_001_R.SHP
      QGIS - GPKG
    4. Insert the following commands after the existing Read GIS SA == gis\2d_sa_M01_002_R.shp command:
      Read GIS SA PITS == 2d_sa_FMT_M02_001_R
    5. Save the file. The tbc file is now ready to be used.

    TUFLOW Control File

    We will need to create a new tcf file that references the new tgc, ecf and tbc files.

    1. Open FMT_M01_001.tcf and save as FMT_M02_DEV_001.tcf. Update the following commands:
      Geometry Control File == ..\model\FMT_M02_001.tgc
      ESTRY Control File == ..\model\FMT_M02_001.ecf
      BC Control File == ..\model\FMT_M02_001.tbc
    2. We have also created a new bc_dbase in this module which will need to be referenced. Update the command as follows:
      BC Database == ..\bc_dbase\bc_dbase_FMT_M02.csv
    3. Lastly, update the following command to specify a new output folder for the results of this module:
      Output Folder == ..\results\FMT_M02\2d
    4. Save the file. The tcf file is now ready to be used.

    Flood Modeller Simulation Files

    1. Open the Flood Modeller Pro model as per Flood Modeller Tutorial Module 1
    2. In the 'Links' tab with the 2D scheme set as TUFLOW, change the full path of the 2D control file to the FMT_M02_DEV_001.tcf from the \FMT_Tutorial\FMT_M02\TUFLOW\runs folder
    3. Save the Scenario Data.

    Use your preferred method to start the model FMT_M02_001.ief or follow the guidance in the Flood Modeller Tutorial Module 1 page. If the simulation fails to start, please refer to the troubleshooting guidance on that page.

    Retrieved from "https://wiki.tuflow.com/w/index.php?title=Flood_Modeller_Tutorial_Module02_Provisional&oldid=43906"