How to view 1D model results as flood maps

There are a number of different approaches to generating flood maps, animations and other outputs from 1D Model results in Flood Modeller.

Some of these options are listed and described in the bullet point list below. These output review options can be selected when you right click either on the map view or on the network table with the loaded 1D model.

     

The chart that results from the options you select is displayed in a new window, like the example below:

This chart includes a right-click menu that provides options to:

In addition to producing time series results from individual or groups of model nodes you can also post-process these data to produce flood maps and animated mapping sequences. These are useful for showing the full impact of flooding in models where water encroaches out of bank onto the surrounding floodplain. The figure below shows a flowchart of the different approaches and the different stages involved in mapping 1D results.

 

 

The following points (alongside the above figure) guide you through the Flood Modeller operations to get from a 1D model to a generic flood map or animated flood event.

  1. A 1D model results file from a model simulation is in a binary format with a zzn file extension (coupled with a zzl file as well). This format is compatible with Flood Modeller and can therefore be uploaded directly. However it is also possible to upload 1D results which have been post-processed to comma separated text format (csv file extension) using the Flood Modeller TabularCSV tool (Results tab). For this latter case your data must have been processed in TabularCSV to the output format 'One Column per Timestep'.
  2. The 1D results are associated to particular nodes within your model. In order to display these data on a map the nodes must be geo-referenced within a TIN file.

    If a TIN file does not exist for a model then Flood Modeller can be used to create one. For this procedure, Flood Modeller requires a polyline shapefile to be created where each model node is represented by a cross section (with a minimum of two points, i.e. a point at either end of each section) or polygon (for reservoir units).

    There are three main data sources available to obtain this required node information. These are:

Alternatively you may already have a TIN file prepared (using another GIS system). In which case you can load this and utilise it directly.

The different options described above are utilised in Flood Modeller as follows (note in some case you may adopt a combination of these methods depending on availability of data):

    1. Import GXY approach - Import a 1D model GXY file and use Flood Modeller to generate geo-referenced cross-sections from this as follows:
      1. Import the GXY file (using the Add GIS Data button under the Home tab). Note that Flood Modeller will import these data as a new point shapefile (you will need to provide a filename for this).
      2. Draw a new shapefile polyline through the points of the GXY file. When editing the shapefile snapping to the gxy node points can be used to ensure the resultant line passes through every point precisely. The snapping control can be accessed under the Layer Editor tab. The new polyline represents a river centre line through the model points.
      3. iii. Click Stop Edit button under the Layer Editor tab to save the new polyline and exit edit mode. With the new centre line highlighted in the Layers panel select the Cross Section Generator from Additional Model Build Tools > 1D Networks in the Toolbox..
      4. Select the appropriate options from the Cross Section Generator window. In particular: ensure that the 'Add cross-section at each point along the shapefile polyline' option is selected; specify an appropriate cross-section length; and reference the gxy points shapefile to provide node labels for each cross section.
      5. Ensure that the cross-sections extend as far as is necessary (to cover the expected flood extent) and that no cross-sections overlap, by using the edit tools to extend, move or rotate selected sections.
      6. Once completed save the cross-section shapefile and use to generate TIN (see point 3).
    2. Import 1D model file approach - If a geo-referenced 1D model .DAT or .SEC file, with cross-sections at each node, exists then this can be loaded and used to generate a TIN. The operation requires the sections to be displayed in the map view so first load the .DAT or .SEC file using the standard Add GIS Data function (or drag the network onto the map from your Project panel). Once displayed the 1D model file can be used directly to generate a TIN (see point 3). If the 1D model file has incomplete geo-referencing then this can be completed by Flood Modeller (providing a valid .GXY file is available with required coordinates for nodes). It should be noted that this approach will only import the river cross section type nodes from your 1D model.
    3. Import cross-section approach - If a geo-referenced cross-section generated in an external piece of software exists, this can be imported directly into Flood Modeller. Software such as MDSF produce geo-referenced cross-sections suitable for this approach. Import the cross-section shapefile using the standard Add GIS Data option, and use the shapefile to generate a TIN (see point 3). In order to transfer node names through to a TIN your imported shapefile must have these data in an attribute field entitled ‘label’’.
    4. Import reservoir polygons approach - If the main area of interest within a model is overbank flooding then the floodplain areas may be defined by a series of 'reservoir' polygons. If these data have been geo-referenced as polygon shapefiles then these data can be imported into Flood Modeller and converted to a TIN in the same way as cross section data (see above). It is also possible to define floodplain reservoirs from within Flood Modeller using the shapefile drawing tools, as described in Layers Editor Tab page of this help file. In order to transfer node names through to a TIN your polygon shapefile must have these data in an attribute field entitled ‘label’.
  1. The next stage is to create a TIN from your cross section data. If you have generated cross-section polyline or reservoir polygon shapefiles by one of the above approaches then this must be done using the TIN Creator tool. This is a standalone tool packaged with Flood Modeller (see the page Tin Creator Tool for details of how to use). In summary the following describes the TIN creation method using TIN Creator:
    1. The TIN Creator tool can be accessed in isolation or from within Flood Modeller. For the latter option access the Layers panel menu by right-clicking on the shapefile layer in the Layers panel, and select Export > To TIN with TIN Creator from the displayed menu. TIN Creator will prompt you for a TIN filename and after this is entered the tool will open with the shapefile automatically loaded. To triangulate click the 'Draw Convex Hull' button and then the 'Triangulate' buttons on the toolbar.
    2. Once triangulated the TIN will be shown on the left-hand side of the screen. Triangles within the TIN that are not needed can be deleted by selecting them (holding down the left shift key and selecting as many triangles as required) and hitting delete. In certain circumstances (when cross-sections used to generate the TIN cross over) pseudo-points will be added to the TIN. These points will not have node references, so users will need to refer the pseudo points to two nearby nodes. This is done by left-clicking on the pseudo point, and then left clicking on the relevant nearby node whilst holding down the left control key (to assign the first nearby node) and repeating the process for whilst holding down the left shift key in place of the control key (for the second node). Experience of using pseudo points has shown that they can cause erroneous flood extents, and thus it may be advisable to make sure that cross-sections do not cross over.
    3. After completing the triangulation process click on the Flood Modeller icon in the TIN Creator toolbar to upload the new TIN in Flood Modeller with the name specified at the start of the process.

Note that Flood Modeller includes options (on the Layers panel right-click menu) to export your 1D model .DAT or .SEC file to shapefile format. The resultant shapefile could then be used in TIN Creator to generate a TIN for your model.

  1. An alternative to using TIN Creator, if you have an 1D model .DAT or .SEC file loaded, is to use the Flood Modeller internal triangulation tool. This generates simplified TINs, which only uses the minimum required points rather than all points in each section (e.g. only two points required to describe a straight line cross section). The following describes this TIN creation method:
    1. The internal TIN generator is run by highlighting your 1D model .DAT or .SEC file in the Layers panel and then selecting 1D Flood Map > Triangulate Selected File from the Modelling Toolbox.
    2. You will be prompted to provide a filename for your new TIN and then the file will be produced and added to the Flood Modeller viewport.
    3. If you right click on a TIN you can select Start Edit from the displayed menu. This will activate the TIN editing toolbar as an extra tab in the main toolbar. The toolbar provides options to draw new triangles and to remove triangles or points (all associated triangles are then also removed).
    4. If new points are added through the drawing of new triangles then you can assign related 1D model node labels to these points by clicking on the Layer Editor toolbar and selecting Attribute Window. This displays a table of all TIN attributes. To assign 1D results you need all Node Label A fields to be populated with valid 1D node names. Edit any cell in the table by double clicking on it and either typing in a node label or adding an existing label from the drop down list displayed below the table (click the adjacent green tick to add a selected label from this list).
    5. Remember to save your edited TIN file before you exit the TIN editing mode.
  2. The next stage is to 'hang' the 1D model .CSV or binary results on the TIN file. For .CSV results, you need to access the Layers panel menu by right-clicking on the TIN layer in the Layers panel, and select the option to Load results. You are prompted to browse to the location of the .CSV or 1D model .ZZN file which has to be associated with the TIN file. The .CSV results file can be in the form of max and min results, or time-series results. For 1D model .ZZN files you are guided through the process of selecting which parameter and which timesteps to load. Another Layers panel menu item enables you to view the list of available results datasets associated with the TIN file and switch between which results are displayed. If Water Quality results file (.zzc file) is available in the same folder as the 1D model results file (.ZZN file), then this .zzc file should automatically be available to load.
  3. If a topography grid is loaded in the Flood Modeller viewport with the TIN results then Flood Modeller can show the resultant flood extent directly by using the included 3D viewer. Flood maps and animations can then be created.
  4. The results can be converted to a flood depth grid or flood extent shapefile using the Flood Modeller flood calculator tool (see the page “How to Use the 1D Flood Calculator”). If multiple time series results are loaded then a batch run can be setup in the flood calculator tool and then left to run in the background, calculating depth grid for multiple time steps. A number of different output formats are available and all grids or shapefiles generated using the flood calculator tool are compatible with third party GIS software.
  5. Flood extents can be saved to snapshot image files (.jpg) either for immediate printing or for use in other applications. Furthermore the snapshot is georeferenced so it can be loaded back into your map view if required and it will appear in the correct location. These options are accessed from the menu accessed by right clicking on the viewport. You should ensure you have orientated the viewport to show the data the way they require before an image is saved. Also you should ensure that any other useful layers are loaded to enhance the image's representation of the flood extent.
  6. If the results attached to the TIN are time-series results these can be animated. To do this right click on the TIN in the Layers panel and select Animate. The animation toolbar will then be loaded at the top of the screen. To start the animation, press the Run Animation button. The Animation toolbar allows enables the animation to be set to continuous loop mode or single run only. Animations can also be recorded to avi files. For further details see the section Animation Controller Toolbar of this manual. It should be noted that the animation of 1D model results is not effective in a 2D canvas. A better result can be obtained by loading the relevant data into the Flood Modeller 3D viewer and animating there.
  7. The Flood Modeller 1D Flood Calculator tool can be used to extract flood extents grids from the 1D results data. Format options available are:

Details of the operation of the 1D Flood Calculator tool are provided on the pageHow to use the 1D Flood Calculator. In addition you may find the following how to guide useful: How to create a flood map from 1D Model results.