Tutorial M10 001 GIS Inputs QGIS GPKG

From Tuflow
Jump to navigation Jump to search


QGIS is used to create, import and view input data.

TUFLOW Project Re-Configuration

Re-configure the TUFLOW project to use and save empty files to the correct folder:

  1. Go to Plugins > TUFLOW > Editing > Configure / Create TUFLOW Project.
  2. Change the folder which contains TUFLOW to the Module_10 folder. This is the only change required, the model folder structure and template empty files are supplied from previous model.
    Note: The 'results' and 'check' folder get automatically created when the TUFLOW model is run.
  3. Click 'OK' and save the QGIS workspace by selecting Project > Save As.

    M10 GPKG ConfigureProject.PNG

  4. Set the QGIS workspace projection to EPSG:32760, see Set the Projection.


Set up the GeoPackage Database:

  1. Navigate to the Module_10\TUFLOW\model\gis folder. Save a copy of M02_001.gpkg as M10_001.gpkg.
  2. Within the QGIS Browser Panel, right click on 'Favorites' and select 'Add a Directory...'.
  3. Navigate to the Module_10 folder and select it.

Within the QGIS Browser Panel, navigate to the Module_10\Tutorial_Data folder. Drag and drop the following layers from their separate databases into the M10_001.gpkg database:

  • 2d_zsh_M10_damwall_001_L
  • 2d_vzsh_M10_dambreak_001_R
  • 2d_iwl_M10_001_R
  • 2d_sa_M10_inflow_001_R

Investigate the supplied files:

  1. Open the files, either:
    • Within the QGIS Browser Panel, navigate to M10_001.gpkg and double click the layers, or
    • In File Explorer, drag and drop the M10_001.gpkg into the QGIS workspace and select the layers (hold Ctrl to select multiple).
  2. The 2d_zsh line layer represents the dam wall:
    • A ‘Z’ attribute of 65 is specified, the elevations are set to 65 metres along the length of the line.
    • The line has the same Shape_Width as the cell size, this is a thick breakline modifying whole cells.

  3. The 2d_vzsh polygon layer represents the location of the dam break:
    • Shape_Width_or_dMax set to less than zero indicates that the vertices along the perimeter of the polygon are used to interpolate elevations.
    • Trigger_Value sets the simulation time in hours that the dam break is to commence. A value of 1 indicates the dam break begins at 1 hour.
    • Period sets the time in hours over which the change in elevation occurs. A value of 0.25 sets a period of 15 minutes replicating the break.
    For more information, see Table 6-9 of the 2018 TUFLOW Manual.

  4. The 2d_iwl polygon layer represents the initial water level of the dam as 59m at all cells within the polygon.

  5. The 2d_sa layer replaces the 2d_bc QT type introduced in Module 1. A 2d_sa inflow is typically more stable in situations of fast model changes, for example, dam breaks.
  6. Select the 2d_sa_M10_inflow_001_R in the Layers panel and use the 'Apply TUFLOW Styles to Current Layer' tool.

Increment the 2d_bc layer from Module 01 and remove the upstream inflow:

  1. Load in the 2d_bc_M01_001_L layer from M10_001.gpkg, either:
    • Within the QGIS Browser Panel, navigate to M10_001.gpkg and double click the layer, or
    • In File Explorer, drag and drop the M10_001.gpkg into the QGIS Workspace and select the layer.
  2. Select the 2d_bc_M01_001_L layer in the Layers panel.
  3. Use the 'Apply TUFLOW Styles to Current Layer' tool.
  4. Click on the ‘Increment Selected Layer’ symbol from the TUFLOW Plugin toolbar.
  5. Within the 'Increment Selected Layer' tool window:
    • Ensure the 'Output Database' is M10_001.gpkg.
    • Ensure the 'Output Layer Name' is 2d_bc_M10_001_L.
    • Select 'Remove Source Layer from Workspace'.
    • Select 'Increment Layer only' and click 'OK'.
    The tool removes the source layer from the Layers panel and the 2d_bc_M10_001_L appears.
    See Increment Layer Tool for more information.
  6. Right click on the 2d_bc_M10_001_L layer to toggle on Editing.
  7. Zoom to the upstream inflow, select and delete the line.
  8. Click 'OK' and turn off editing to save the edits.


  • A 2d_zsh layer was checked to enforce a dam wall in the model.
  • A 2d_vzsh layer was inspected to simulate a break in the dam wall.
  • A 2d_iwl layer was reviewed setting the initial water level within the dam upstream of the dam wall.
  • The original upstream inflow was removed from the model, replaced by a source area boundary.

Go-up.png Back to Module 10 Main Page