Difference between revisions of "TUFLOW QGIS Plugin"

From Tuflow
Jump to navigation Jump to search
 
(116 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
=Introduction=
 
=Introduction=
This page describes the process of running the TUFLOW QGIS plugin.  At this stage it is still a beta and once we have tested it further it will be made available for the official QGIS repository... Please report any issues or feedback to support@tuflow.com.<br><br>
+
If you are using QGIS as your model development or result viewing environment we strongly recommend installing the TUFLOW QGIS Plugin. It includes numerous tools to increase workflow efficiency. It also includes powerful result viewing functionality via its <u>[[TUFLOW_Viewer | TUFLOW Viewer]]</u>. This page describes the process of installing and using the Plugin.  
The plugin is available for version 2.x, a previous version was available for QGIS 1.8, however, this is no longer being actively developed.
+
<br>
<br>
 
=Prerequisites=
 
The plugin uses the following python modules which '''may''' need to be separately installed.  These may have been installed with other software, to check if they are installed on your machine, you can install the plugin (see instructions below) and check that the required dependencies are installed. To do this run '''TUFLOW > About > Check Python Dependencies Installed''' from the menu.  All going well you will get a notification to tell you that the required modules are installed. If not, you will be notified if you need to install either of the the python modules below:<br>
 
Please ensure QGIS / python is installed before installing the below.<br>
 
* numpy (see http://sourceforge.net/projects/numpy/files/NumPy/1.6.1/numpy-1.6.1-win32-superpack-python2.7.exe/download)
 
* matplotlib (see http://sourceforge.net/projects/matplotlib/files/matplotlib/matplotlib-1.1.0/matplotlib-1.1.0.win32-py2.7.exe/download)
 
A number of other python modules are required, however, these should be installed with QGIS / python.
 
 
 
 
=Installation of Plugin=
 
=Installation of Plugin=
 +
To enable the plugin please follow the instructions below:
 
<ol>
 
<ol>
To enable the plugin please follow the instructions below:
+
<li>Download the plugin from the QGIS official repository,  '''Plugins >> Manage and Install Plugins'''</li>
<li>Make sure you have QGIS installed and the prerequisites installed (see above).</li>
+
[[File:QGIS_TUFLOW_000.PNG|400px]]
<li>Download the plugin, from the [https://github.com/TUFLOW-Support/QGIS-TUFLOW-Plugin GitHub repository] a direct link to the zip file is:</li>
+
<li>In the manager, search for "TUFLOW".</li>
https://github.com/TUFLOW-Support/QGIS-TUFLOW-Plugin/archive/master.zip
+
<li>Select TUFLOW, and "Install Plugin".</li>
 +
[[File:QGIS_TUFLOW_001.PNG|400px]]
 +
<li>Once enabled the plugin should be accessible from the '''Plugins >> TUFLOW''' menu item:</li>
 +
[[File:QGIS_TUFLOW_003.PNG|400px]]
 +
<li>Before using, check that the prerequisite python modules are also installed (see below).
 +
</ol><br>
 +
 
 +
=Development Version=
 +
It's possible to test out the latest development version of the plugin and TUFLOW Viewer by following the instructions below:<br>
 +
<b><u>[[Installing_the_Latest_Development_Version_of_the_TUFLOW_Plugin | Installing the Latest Development Version of the TUFLOW Plugin]]</u></b>
 +
<br><br>
  
<li>Extract the zip file and then copy or move the "TUFLOW" folder into your QGIS plugin directoryThis should be "C:\Users\<username>\.qgis2\python\plugins"</li>
+
= Prerequisites=
<li>Open QGIS and from the menu select '''Plugins >> Manage and Install Plugins...'''.  In the manager, find the plugin "TUFLOW" and select the check box to enable the plugin.</li>
+
The TUFLOW plugin uses the following python modules which '''may''' need to be separately installedThese may have been installed with other software, to check if they are installed on your machine:  
[[File:QgisTuflow PluginManager.JPG|300px]]
+
<ol>
<li>Once enabled the plugin should be accessible from the '''Plugin >> TUFLOW''' menu item:</li>
+
<li> Install the TUFLOW plugin (see instructions above)</li>
[[File:QgisTuflow Menu.jpg]]
+
<li> Open the TUFLOW plugin '''Plugins >> TUFLOW''' </li>
 +
<li> Check that the required dependencies are installed from the menu. '''TUFLOW >> About >> Check Python Dependencies Installed'''</li>
 +
[[File:QGIS_TUFLOW_004.PNG|600px]]
 
</ol>
 
</ol>
 +
 +
All going well you will get a notification to tell you that the required modules are installed. If not, you will be notified if you need to install either of the python modules below:<br>
 +
Please ensure QGIS / python is installed before installing the below.<br>
 +
* numpy (see https://sourceforge.net/projects/numpy/files/NumPy/1.6.1/numpy-1.6.1-win32-superpack-python2.7.exe/download)
 +
* matplotlib (see https://sourceforge.net/projects/matplotlib/files/matplotlib/matplotlib-1.1.0/matplotlib-1.1.0.win32-py2.7.exe/download)
 +
<br>
  
 
=Usage=
 
=Usage=
 +
Each function in the utility has a separate page documenting the usage.
 +
 +
The first step for a project is to create the project / save the settings with the [[QGIS_TUFLOW_Create_Project | Create or Configure TUFLOW Project]] tool.  Subsequent tools rely on the information stored at this stage to work best.
 +
 +
=== Editing Tools ===
 
<ol>
 
<ol>
Please see the page for each tool.
 
'''Editing Tools'''<br>
 
 
<li> [[QGIS_TUFLOW_Create_Project | Create or Configure TUFLOW Project]]</li>
 
<li> [[QGIS_TUFLOW_Create_Project | Create or Configure TUFLOW Project]]</li>
<li> [[QGIS_TUFLOW_Import_Empty | Import Empty (template GIS file]]</li>
+
<li> [[QGIS_TUFLOW_Import_Empty | Import Empty (template GIS file)]]</li>
 +
<li> [[QGIS_TUFLOW_Insert_TUFLOW_Attributes_to_Existing_Layer | Insert TUFLOW Attributes to Existing Layer]]</li>
 
<li> [[QGIS_TUFLOW_Increment_Layer | Increment Selected Layer]]</li>
 
<li> [[QGIS_TUFLOW_Increment_Layer | Increment Selected Layer]]</li>
'''Visualisation Tools'''<br>
+
<li> [[QGIS_TUFLOW_Reload_Data | Reload Data]]
<li> [[QGIS_TUFLOW_View_Results | View Results]]</li>
+
<li> [[QGIS_TUFLOW_Arch_Bridge_Editor | Arch Bridge Editor]]
<li> [[QGIS_TUFLOW_View_Sections | View Cross-Sections]]</li>
+
<li> [[QGIS_TUFLOW_Copy_TUFLOW_Command | Copy TUFLOW Command]]
'''Run Tools'''<br>
+
</ol>
 +
=== Run Tools ===
 +
<ol>
 
<li> [[QGIS_TUFLOW_Run_TUFLOW | Run TUFLOW simulation]]</li>
 
<li> [[QGIS_TUFLOW_Run_TUFLOW | Run TUFLOW simulation]]</li>
<li>Step 1 is to check that the required dependencies are installed.  To do this run TUFLOW > About > Check Python Dependencies Installed from the menu.  All going well you will get a notification to tell you that the required modules are installed.</li>
+
<li> [[TUFLOW_Runner | TUFLOW Runner]]</li>
<li>The next step is to configure a TUFLOW project.  This is project dependent and stores the location of the TUFLOW executable, working directory and projection.  This can be accessed from TUFLOW > Editing > Configure TUFLOW Project.
+
<li> [[QGIS_TUFLOW_Run_TUFLOW_Utilities | Running TUFLOW Utilities]]</li>
This saves the information in the QGIS project.  This information is used later, for example when you use the Run TUFLOW, the utility defaults to running the most recent .tcf file in the specified TUFLOW directory, defined at this step.<br>
+
</ol>
'''Note:''' The location specified, should be the folder that contains (or will contain) the TUFLOW folder. For example if the TUFLOW directory is "L:\Projects\Dummy\Modelling\TUFLOW\" then "L:\Projects\Dummy\Modelling\" should be defined in this dialogue.</li>
+
 
<li>After configuring the project ensure you save your project.</li>
+
=== Visualisation Tools ===
 +
<ol>
 +
<li> [[TUFLOW_Viewer | TUFLOW Viewer ]](result visualisation toolkit)
 +
<li> [[QGIS_TUFLOW_Styles | Applying TUFLOW styles]]
 +
<li> [[QGIS_TUFLOW_Import_Check_Files_From_Folder | Import Check Files From Folder]]
 +
<li> [[QGIS_TUFLOW_Load_Layers_From_TCF | Load TUFLOW Layers From TCF]]
 +
<li> [[QGIS_TUFLOW_Filter_and_Sort_TUFLOW_Layers | Filter and Sort TUFLOW Layers]]
 +
<li> [[QGIS_TUFLOW_Apply_GPKG_Layer_Names | Apply GPKG Layer Names]]
 +
<li> [[QGIS_TUFLOW_Apply_Label_to_Current_Layer | Apply Label to Current Layer]]
 +
<li> [[QGIS_TUFLOW_Apply_Stability_Styling | Apply Stability Styling]]
 +
</ol>
 +
=== Hydrology Tools ===
 +
<ol>
 +
<li> [[QGIS_ARR_to_TUFLOW | ARR to TUFLOW]]
 +
<li> [[QGIS_ReFH2_to_TUFLOW | ReFH2 to TUFLOW]]
 +
<li> [[QGIS_SCS_to_TUFLOW | SCS to TUFLOW]]
 +
</ol>
 +
=== Integrity Tools ===
 +
<ol>
 +
<li> [[1D_Integrity_Tool | 1D Integrity Tool]]
 +
</ol>
 +
=== SWAN GIS Tools ===
 +
For more information on SWAN GIS Tools please visit the following TUFLOW FV Wiki page: '''<u>[https://fvwiki.tuflow.com/index.php?title=SWAN_GIS_Tools SWAN GIS Tools]</u>'''. Links to the individual tools on the TUFLOW FV Wiki area also provided below:
 +
<ol>
 +
<li> [https://fvwiki.tuflow.com/index.php?title=SWAN_GIS_Model_Builder SWAN GIS Model Builder]
 +
<li> [https://fvwiki.tuflow.com/index.php?title=SWAN_GIS_Post_Processing SWAN GIS Post Processing]
 +
</ol>
 +
=== Processing Toolbox ===
 +
<ol>
 +
<li> [[Convert_TUFLOW_Model_GIS_Format | Convert TUFLOW Model GIS Format]]
 +
<li> [[Package_Model_in_QGIS | Package Model]]
 +
<li> SWMM Tools:
 +
<ol><li>[[QGIS_SWMM_BC_Create_Channel_Endpoint_1D/2D_Connections | BC - Create channel endpoint 1D/2D connections]]
 +
<li> [[QGIS_SWMM_Conduits_Assign_Losses | Conduits - Assign losses]]
 +
<li> [[QGIS_SWMM_Conduits_Assign_Node_Fields | Conduits - Assign node fields]]
 +
<li> [[QGIS_SWMM_Convert_ESTRY_Layers_To_SWMM | Convert - ESTRY layers to SWMM]]
 +
<li> [[QGIS_SWMM_Convert_XPSWMM_GIS_Inlet_Layers_to_SWMM | Convert - XPSWMM GIS inlet layers to SWMM]]
 +
<li> [[QGIS_SWMM_Convert_XPSWMM_Hydrology_(beta) | Convert - XPSWMM Hydrology (beta)]]
 +
<li> [[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX | Convert - XPSWMM model from XPX (beta)]]
 +
<li> [[QGIS_SWMM_GeoPackage_Add_Sections | GeoPackage - Add sections]]
 +
<li> [[QGIS_SWMM_GeoPackage_Create | GeoPackage - Create]]
 +
<li> [[QGIS_SWMM_GeoPackage_Create_from_SWMM_inp | GeoPackage - Create from SWMM inp]]
 +
<li> [[QGIS_SWMM_GeoPackage_Write_to_SWMM_inp | GeoPackage - Write to SWMM inp]]
 +
<li> [[QGIS_SWMM_Integrity_Make_Object_Names_Unique| Integrity - Make object names unique]]
 +
<li> [[QGIS_SWMM_Junctions_Convert_HX_Nodes_to_Storage| Junctions - Convert HX nodes to storage]]
 +
<li> [[QGIS_SWMM_Junctions_Downstream_Junctions_to_Outfalls| Junctions - Downstream junctions to outfalls]]
 +
<li> [[QGIS_SWMM_Junctions_Set_Attributes| Junctions - Set attributes]]
 +
<li> [[QGIS_SWMM_Outfalls_Fix_Multiply_Connected_Links| Outfalls - Fix multiply connected links]]
 +
 
 
</ol>
 
</ol>
[[File:QgisTuflow Configure01.JPG|400px]]
+
</ol>
==Create TUFLOW directory==
+
 
The first step in creating a TUFLOW model is typically to create a TUFLOW directory structure, define a projection file and run TUFLOW to create the empty (template) TUFLOW files.  This can be done in a single step using the TUFLOW > Editing > Create TUFLOW directory tool.<br>
+
If you encounter any issues with the plugin please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.<br>
[[File:QgisTuflow CreateDirectory.JPG|400px]]
 
 
<br>
 
<br>
<br>
 
The TUFLOW folder will be created under this location.  If the "Run TUFLOW to create empties" is checked, after creating the folder structure, a TUFLOW simulation will be started which creates the empty (template) files under the "TUFLOW\model\gis\empty\" folder.
 
==Import Empty File==
 
This tool will grab a default TUFLOW type (e.g. 1d_bc or 2d_zsh) copy this from '''TUFLOW\model\gis\empty\''' into '''TUFLOW\model\gis''' and rename the file.  The output name is "file type"+"Run ID"+Geometry.shp.  For example 2d_zsh_run01_L.shp for a line, 2d_zsh_run01_P.shp for a point or 2d_zsh_run01_R.shp for region.  The file will be opened and added to the layers.<br>
 
Multiple empty types and geometries can be imported at the same time.<br>
 
  
[[File:QgisTuflow ImportEmpty01.JPG]]
+
=Error While Upgrading Plugin=
<br>
+
[[File:Plugin_uninstall_failed.PNG]]<br>
<br>
+
If you receive an error while trying to upgrade the TUFLOW plugin you may need to either:<br>
'''Note:''' Not all geometry types exist for all TUFLOW types.  For example 1d_bc, points and regions are valid, however lines are not.  For more information on the TUFLOW empty types, please refer to the tables in the TUFLOW manual.
+
<ol>
==Increment Selected==
+
<li> Restart QGIS and try upgrading the plugin again
As the name implies, this tool, takes the active layer (selected in the layer control) and saves a new copy of this.  The current copy will be closed and the new version opened.  There is an option to keep the existing source formatting, if this is selected a .qml file is saved based on the styling of the current layer.<br>
+
<li> Manually remove the old version
[[File:QgisTuflow Increment01.JPG]]
+
</ol>
<br>
+
 
==View 1D Results==
+
Errors are most likely caused by an issue with deleting the old version of the plugin as some part of the plugin is still being used somewhere in memory (RAM) and locking permissions. This is a known issue that occur with the ReFH2 to TUFLOW tool in older versions of the plugin. Simply restarting QGIS and retrying the upgrade process should fix the issue.
This allows the user to view 1D results as time-series or long profiles.  This requires that the results are from a 2013-12-AA simulation or newer. Once the utility is started the results can be loaded using the "Add Results" button.  The .info file (TUFLOW\results\1d\csv\) is the file to load, this tells the utility which .csv files need to be loaded.<br>
+
 
When using the utility the ID of the selected GIS objects is used to find the results in the .csv files.  This can either be an input file (1d_nwk) or the check files.  The '''_nwk_N_check''' (contains all nodes) and  and '''_nwk_C_check''' (contains all channels) are very useful for this purpose.<br>
+
=== Manually removing the TUFLOW plugin ===
If a file containing lines is selected in the layer control, the utility allows viewing of channel data (time-series of flow, velocity and upstream and downstream water levels or long profiles). If a point geometry is selected, the utility will plot the node data (time-series of water level).<br>
+
To manually remove the TUFLOW plugin simply delete the 'tuflow' folder from the QGIS plugin directory (you may need to close QGIS first):<br>
Multiple locations can be selected in the map window and these will be plotted. If viewing long profiles, the following logic applies:
+
<ol>
* If a single channel is selected, all channels downstream will be plotted;
+
<li>'''Windows''' - %appdata%\QGIS\QGIS3\profiles\default\python\plugins
* If two channels are selected, a long section will be plotted between these;
+
<li>'''Linux''' - /home/USER/.local/share/QGIS/QGIS3/profiles/default/python/plugins
* If more than two channels are selected an error will be issued.<br>
+
</ol>
See images below.<br>
+
 
[[File:QgisTuflow ResViewer001.JPG|400px]]
+
=Changelog=
[[File:QgisTuflow ResViewer002.JPG|300px]]
+
 
==View 1D Sections==
+
[https://docs.tuflow.com/qgis-tuflow-plugin/changelog/ https://docs.tuflow.com/qgis-tuflow-plugin/changelog/]
This allows the user to plot 1D sections, in the 1d_xs or 1d_tab format. The active layer in the table of contents should be the layer contain the cross sections. Select a section or sections in the map window will plot the sections.
 
[[File:QgisTuflow XSViewer001.JPG|400px]]
 
  
==Run TUFLOW Simulation==
 
Start a TUFLOW simulation.  The default control file is the most recent file in the TUFLOW\runs\ folder, the default executable is defined in the "Configure TUFLOW project". If the "Configure TUFLOW project" tool has not been run, no default values exist.
 
 
<br>
 
<br>
[[File:QgisTuflow RunTUFLOW01.JPG]]
+
{{Tips Navigation
 +
|uplink=[[QGIS_Tips| Back to QGIS Tips Main Page]]
 +
}}
 +
<br><br><br><br>
 +
{{Tips Navigation
 +
|uplink=[[Main_Page| Back to Wiki Main Page]]
 +
}}

Latest revision as of 15:04, 12 August 2024

Introduction

If you are using QGIS as your model development or result viewing environment we strongly recommend installing the TUFLOW QGIS Plugin. It includes numerous tools to increase workflow efficiency. It also includes powerful result viewing functionality via its TUFLOW Viewer. This page describes the process of installing and using the Plugin.

Installation of Plugin

To enable the plugin please follow the instructions below:

  1. Download the plugin from the QGIS official repository, Plugins >> Manage and Install Plugins
  2. QGIS TUFLOW 000.PNG
  3. In the manager, search for "TUFLOW".
  4. Select TUFLOW, and "Install Plugin".
  5. QGIS TUFLOW 001.PNG
  6. Once enabled the plugin should be accessible from the Plugins >> TUFLOW menu item:
  7. QGIS TUFLOW 003.PNG
  8. Before using, check that the prerequisite python modules are also installed (see below).


Development Version

It's possible to test out the latest development version of the plugin and TUFLOW Viewer by following the instructions below:
Installing the Latest Development Version of the TUFLOW Plugin

Prerequisites

The TUFLOW plugin uses the following python modules which may need to be separately installed. These may have been installed with other software, to check if they are installed on your machine:

  1. Install the TUFLOW plugin (see instructions above)
  2. Open the TUFLOW plugin Plugins >> TUFLOW
  3. Check that the required dependencies are installed from the menu. TUFLOW >> About >> Check Python Dependencies Installed.
  4. QGIS TUFLOW 004.PNG

All going well you will get a notification to tell you that the required modules are installed. If not, you will be notified if you need to install either of the python modules below:
Please ensure QGIS / python is installed before installing the below.


Usage

Each function in the utility has a separate page documenting the usage.

The first step for a project is to create the project / save the settings with the Create or Configure TUFLOW Project tool. Subsequent tools rely on the information stored at this stage to work best.

Editing Tools

  1. Create or Configure TUFLOW Project
  2. Import Empty (template GIS file)
  3. Insert TUFLOW Attributes to Existing Layer
  4. Increment Selected Layer
  5. Reload Data
  6. Arch Bridge Editor
  7. Copy TUFLOW Command

Run Tools

  1. Run TUFLOW simulation
  2. TUFLOW Runner
  3. Running TUFLOW Utilities

Visualisation Tools

  1. TUFLOW Viewer (result visualisation toolkit)
  2. Applying TUFLOW styles
  3. Import Check Files From Folder
  4. Load TUFLOW Layers From TCF
  5. Filter and Sort TUFLOW Layers
  6. Apply GPKG Layer Names
  7. Apply Label to Current Layer
  8. Apply Stability Styling

Hydrology Tools

  1. ARR to TUFLOW
  2. ReFH2 to TUFLOW
  3. SCS to TUFLOW

Integrity Tools

  1. 1D Integrity Tool

SWAN GIS Tools

For more information on SWAN GIS Tools please visit the following TUFLOW FV Wiki page: SWAN GIS Tools. Links to the individual tools on the TUFLOW FV Wiki area also provided below:

  1. SWAN GIS Model Builder
  2. SWAN GIS Post Processing

Processing Toolbox

  1. Convert TUFLOW Model GIS Format
  2. Package Model
  3. SWMM Tools:
    1. BC - Create channel endpoint 1D/2D connections
    2. Conduits - Assign losses
    3. Conduits - Assign node fields
    4. Convert - ESTRY layers to SWMM
    5. Convert - XPSWMM GIS inlet layers to SWMM
    6. Convert - XPSWMM Hydrology (beta)
    7. Convert - XPSWMM model from XPX (beta)
    8. GeoPackage - Add sections
    9. GeoPackage - Create
    10. GeoPackage - Create from SWMM inp
    11. GeoPackage - Write to SWMM inp
    12. Integrity - Make object names unique
    13. Junctions - Convert HX nodes to storage
    14. Junctions - Downstream junctions to outfalls
    15. Junctions - Set attributes
    16. Outfalls - Fix multiply connected links

If you encounter any issues with the plugin please contact support@tuflow.com.

Error While Upgrading Plugin

Plugin uninstall failed.PNG
If you receive an error while trying to upgrade the TUFLOW plugin you may need to either:

  1. Restart QGIS and try upgrading the plugin again
  2. Manually remove the old version

Errors are most likely caused by an issue with deleting the old version of the plugin as some part of the plugin is still being used somewhere in memory (RAM) and locking permissions. This is a known issue that occur with the ReFH2 to TUFLOW tool in older versions of the plugin. Simply restarting QGIS and retrying the upgrade process should fix the issue.

Manually removing the TUFLOW plugin

To manually remove the TUFLOW plugin simply delete the 'tuflow' folder from the QGIS plugin directory (you may need to close QGIS first):

  1. Windows - %appdata%\QGIS\QGIS3\profiles\default\python\plugins
  2. Linux - /home/USER/.local/share/QGIS/QGIS3/profiles/default/python/plugins

Changelog

https://docs.tuflow.com/qgis-tuflow-plugin/changelog/


Up
Go-up.png Back to QGIS Tips Main Page





Up
Go-up.png Back to Wiki Main Page