QGIS TUFLOW Arch Bridge Editor

From Tuflow
Jump to navigation Jump to search

This Page is Currently Under Construction


Up
Go-up.png Back to TUFLOW QGIS Plugin Main Page




The Interface

Arch bridge editor interface.PNG

  1. GIS Inputs
    • Location for providing 1d_nwk and 1d_xs inputs. The 1d_nwk layer and the bridge feature must already exist. It is not required that the arch bridge attributes are filled out, however the spatial geometry should be represented already (i.e. the polyline must already be drawn).
    • The 1d_nwk layer should be selected in the first dropdown box, and the arch bridge feature in the second dropdown box. The arch bridge can be selected within the map window using the selection tool Arch bridge feature selection button.PNG (from within the arch bridge editor dock, not the standard QGIS tool). The tool will automatically find any 1d_xs features intersecting the bridge polyline if a 1d_xs layer is selected in the third dropdown box. If "-None" is selected in the third dropdown box, the tool will automatically create a 1d_xs feature.
    • The text below the GIS inputs will provide the status on the GIS inputs e.g. Whether the tool has found any 1d_xs intersecting the arch bridge polylline.
  2. Arch Bridge Tables
    • Location for viewing and editing the waterway cross-section and bridge tables. The tables will load automatically if data is found in the GIS inputs. The tables can also be reloaded from the GIS inputs using the reload buttons next to the relevant GIS inputs.
    • A name must be provided for both the cross-section and bridge tables.
    • Numerous options are provided for creating/importing/editing/visualising the tables on the right-hand side of the cross-section table (these can be used for both tables). See Arch Bridge Table Options for more information.
    • The "General Data" tab contains other possible parameters for arch bridge modelling in TUFLOW (see relevant section of the TUFLOW Manual / 2022 Release Notes).
  3. TUFLOW Outputs
    • Location for specifying output options. See Output Options for more information on the output types.
    • "Reset" will reset inputs in the GUI so the user can start from a clean interface.
    • "Output to TUFLOW" will run the tool.

Arch Bridge Table Options

Creating Tables

The +/- symbols can be used to add and remove rows from the arch bridge tables. Adding and removing rows can also be done via the context menu by right-clicking the row numbers on the left-hand side of the table. The tables also support copying and pasting values from spreadsheets.
Arch bridge editor table context menu.PNG

Import From Text File

Values can also be imported from text files using "Import > Import Data From Text File" and using the wizard to specify the delimiter and which columns to import.
Arch bridge editor import text file.PNG

Import From Flood Modeller

Arch bridge data can be imported from a flood modeller ".dat" file using "Import > Import Data From FM .dat File". The tool will scan the input file for all arch bridges and give the user a list of possible imports. Only one bridge can be imported at a time (for a single run of the tool).
Arch bridge editor import dat.PNG

From DEM

The cross-section can be generated by cutting a section from an open raster layer. This can be done by using "From DEM > [select desired DEM]" then drawing a line in the map window (left-click to add a vertex, and right-click to finish). The drawn line will not be used when generating the spatial location of any 1d_xs feature and can therefore be drawn anyway and does not need to intersect the arch bridge polyline (e.g. it could be drawn upstream of the bridge as a representative cross-section).
Arch bridge editor from dem.PNG

The graphic layer can be cleared from the map window using "Clear Graphic". The graphic layer can also be exported to a SHP file by using "Graphic -> Layer".

Visualising Tables

Plot

The cross-section and the bridge can be visualised using the "Plot" button. The cross-section can be plotted without any bridge data, however the bridge cannot be plotted without any cross-section data.
Arch bridge editor plot.PNG

Bridge Curves

Post-processed arch bridge curves can be imported to view along side the plotted bridge data, or by themselves, by using "Bridge Curves > Import Bridge Curve From EOF". As the menu name suggests, the processed bridge inputs can be imported into the editor from the Estry Output File (EOF). This requires the pre-processing of the arch bridge data to have been completed by TUFLOW (this is done sometime in the initialisation phase of a TUFLOW run and therefore does not require TUFLOW to have finished before checking).
Arch bridge editor bridge curves.PNG

Output Options

In all output options, the 1d_nwk attributes of the input layer and selected feature will be overwritten with the data from the bridge editor. The below options refer to the 1d_xs output. Any newly generated 1d_xs feature will be drawn as single line perpendicular to the arch bridge polyline at the mid point.

New Layer

This option will create a new TUFLOW 1d_xs layer and populate it with the bridge cross-section.

Append to Existing Layer

This option will create a new 1d_xs feature in the selected 1d_xs layer (third dropdown option in the GIS inputs). This option requires an existing layer to be selected (cannot use "-None-" in the XS layer dropdown).

Overwrite Existing Items

This option will overwrite any existing 1d_xs feature if one is already intersecting the arch bridge polyline. If there is no existing intersecting feature, then a new feature will be appended to the 1d_xs layer (same as "Append to Existing Layer" output option above). This option requires an existing layer to be selected (cannot use "-None-" in the XS layer dropdown).

Refactoring Fields

The new arch bridge type in TUFLOW requires a "Type" field character length longer than the GIS empty types prior to 2022 release provided (i.e. 'BArch' requires 5 characters, the character length of the "Type" field in the 1d_nwk empty type prior to the 2022 release was limited to 4). If the 1d_nwk layer is detected to have insufficient length in the "Type" field, the tool will refactor the fields so they match the 2022 release 1d_nwk empty type. This will be ouput as a temporary "memory" layer in QGIS. This layer will be lost if QGIS is closed and it up to the user to save this layer to disk.

Example: Creating a New Arch Bridge

This example demonstrates how to create a new arch bridge input from scratch using bridge data from an existing Flood Modeller model. This example serves as a demonstration only and the data in the example is not provided. The steps undertaken are listed below

  1. Create a new 1d_nwk layer
  2. Draw the arch bridge channel
  3. Populate the GIS inputs in the arch bridge editor
  4. Import bridge information from an existing Flood Modeller .dat file
  5. Run the tool to create a new 1d_xs layer

1. Create a new 1d_nwk layer

An existing 1d_nwk layer is required as an input into the tool. For this demonstration, a new 1d_nwk was created using the Import Empty Tool.
Arch bridge editor example1 import empty.gif

2. Draw Arch Bridge Channel

An existing arch bridge polyline is also required as an input into the tool. The polyline does not require any attributes to be filled out or completed, however the spatial geometry must already be present. In this example, open channels ('S' types) are already present and an arch bridge is drawn to connect the upstream reach to the downstream reach. Note: no attributes are populated in the newly created channel, an ID could be provided to make it slightly easier to find the drawn bridge line in the arch bridge editor.
Arch bridge editor example1 draw bridge.gif

3. Populate the GIS Inputs

In this step, the arch bridge editor is opened and the GIS inputs are populated. The first dropdown will point to the 1d_nwk layer created in Step 1. The 'Select Feature on Map' tool is used to select the newly drawn arch bridge polyline in Step 2. Note: the 1d_xs layer dropdown box is left as "-None-" so that the tool will automatically create the 1d_xs layer. This information is provided in the status text located below the GIS inputs. The status text indicates that a 1d_xs layer will be created and that the "Inlet_Type" attribute is blank (this is where the bridge data CSV is referenced). If the "Inlet_Type" wasn't blank, the editor would try and populate the bridge table.
Arch bridge editor example1 gis inputs.gif

4. Import Bridge Information

The bridge data is imported from an existing Flood Modeller .dat file in this step. This will populate the cross-channel and bridge tables, as well fill-in the name attributes in the editor. Note: the "General Data" tab is also populated based on the imported bridge. Once the tables are populated, the "Plot" tool can be used to visualise the data.
Arch bridge editor example1 import data.gif

5. Run the Tool

The final step is to run the tool. Since in this example we're creating input layers from scratch and there is no 1d_xs layer yet, the "New Layer" option is chosen. This will create a new 1d_xs layer and populate it with a cross-section line running perpendicular to the arch bridge channel. Note: after the tool is run, the editor is populated with the new output files.
Arch bridge editor example1 run tool.gif

Example: Viewing and Editing an Existing Arch Bridge

This example demonstrates how to view then make edits to an existing arch bridge layer. This example serves as a demonstration only and the data in the example is not provided. The steps undertaken are:

  1. Open 1d_nwk layer and 1d_xs layer containing the arch bridge channel and cross-section respectively
  2. Open the arch bridge editor and select the GIS inputs
  3. Make edits and run the tool

Open Existing TUFLOW Layers

In this step, layers are opened in QGIS by dragging and dropping them in from file explorer. The layers are fully complete arch bridge input layers for a TUFLOW model and contain all relevant data required for the arch bridge editor.
Arch bridge editor example2 open layers.gif

Open Arch Bridge Editor and Select GIS Inputs

This step shows how to open the arch bridge editor and select the input GIS layers. Because the layers are existing input layers (and all relevant attributes are populated), the editor will load in the table data automatically once the inputs are selected. The bridge geometry can then be visualised using the "Plot" button.
Arch bridge editor example2 select gis inputs.gif

Make Edits and Run the Tool

This step shows how to make edits to the existing bridge and then export the changes. This demonstration uses the output option 'Overwrite Existing Items' which will overwrite the current inputs. This generally isn't recommended to do without first incrementing the layer using the Increment Tool. The tool will produce confirmation dialogs if the output CSV files (cross-section and bridge tables) already exist. The edits made in this step is simply modifying the bridge obvert and springing level.
Arch bridge editor example2 edit run tool.gif


Up
Go-up.png Back to TUFLOW QGIS Plugin Main Page