QGIS TUFLOW Insert TUFLOW Attributes to Existing Layer

From Tuflow
Revision as of 19:39, 18 July 2024 by ElizaCollison (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This tool gives users the ability to insert the appropriate TUFLOW attributes infront of an existing GIS layer. The features in the existing layer will be maintained including all the existing attribute data which will be located after the TUFLOW attributes. This can be useful for keeping a record of the original data, and it also makes it easier for users to then map the appropriate data across into the TUFLOW attribute fields. Once the TUFLOW attributes have been populated, the layer can then be used directly in TUFLOW model (the old attributes are not required to be deleted prior to running in TUFLOW).

Running the Tool

The tool can be found in the TUFLOW Plugin toolbar, or via the QGIS menu Plugins >> TUFLOW >> Insert TUFLOW attributes to existing GIS layer
Insert TUFLOW Attributes ToolIcon.PNG
Insert TUFLOW Attr Dialog.PNG

The setup of the tool is similar to the Import Empty Tool.

  1. Empty Directory - The user is required to choose the the directory where TUFLOW empty files are located - this will automatically be populated if the user has run the Configure Project tool, or has setup a global location, or has previously saved an empty file location.
  2. Input Layer - the existing GIS vector layer that will have TUFLOW attributes added to the front (it will create a new file and won't overwrite the existing file).
  3. TUFLOW attribute type - the TUFLOW empty layer that will be used as a template for which attribute types are required
  4. Run ID - the name of the output file. The output file name will follow the same convention as the Import Empty Tool - <empty_type>_<Run_ID>_<geometry_type><file_ext> - e.g. 1d_nwk_run_001_L.shp
  5. Save directory to Project - saves the empty directory to the QGIS project (.qgs/.qgz). This saves the location the next time this tool, or the import empty tool, is opened inside this project. A similar option is available in the import emtpy tool which will also affect this tool.
  6. Save directory to Global - saves the empty directory globally for all QGIS workspaces. If a directory has been saved to the project (see above), the project directory location will take precedence over the global location. This location will save the empty directory for this tool and the import empty tool, conversely the import empty tool has a similar option that will affect this tool.
  7. Output Database - Available in v3.3 - Specifies an existing or new GPKG database. If an output database is specified, the tool will output the new layer into the database (converting formats if required).

Note: for 1d_nwk layers the tool will automatically update the empty type to 1d_nwke if there are more than 10 attributes in the original input layer. The reason for this is that if a given 1d_nwk input into TUFLOW has 30 or more attribute fields, TUFLOW will interpret this as a 1d_nwke and therefore will produce an error if the 1d_nwke empty type isn't used. The additional fields added in the 1d_nwke (10) should be left blank, and will be ignored by TUFLOW. TUFLOW will then treat this layer in the same way as a 1d_nwk layer.

Note 2: since v3.3 the tool also accepts GPKG empty files. If an output database is not specified, the output layer format will match the format of the empty file. The GPKG format is a newly accepted format in TUFLOW since the 2022 release.

Example

Insert TUFLOW Attributes example.gif

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