Difference between revisions of "1D Integrity Tool"
Ellis Symons (talk | contribs) |
|||
| (13 intermediate revisions by 3 users not shown) | |||
| Line 13: | Line 13: | ||
==Installation or Version Upgrade== | ==Installation or Version Upgrade== | ||
===Installation=== | ===Installation=== | ||
| − | The 1D Integrity Tool is a free tool that comes as part of the TUFLOW plugin in QGIS. For instructions on how to install the plugin, please follow these steps:<u>[[TUFLOW_QGIS_Plugin#Installation_of_Plugin | Installation of Plugin]]</u>.<br> | + | The 1D Integrity Tool is a free tool that comes as part of the TUFLOW plugin in QGIS. For instructions on how to install the plugin, please follow these steps:<u>[[TUFLOW_QGIS_Plugin#Installation_of_Plugin | Installation of TUFLOW QGIS Plugin]]</u>.<br> |
There are also instructions on installing plugins in the QGIS documentation - if you choose to follow the QGIS documentation, the plugin is called "TUFLOW" in the repository: <u> [https://docs.qgis.org/3.16/en/docs/training_manual/qgis_plugins/fetching_plugins.html Link to QGIS Documentation - Installing and Managing Plugins]</u>.<br> | There are also instructions on installing plugins in the QGIS documentation - if you choose to follow the QGIS documentation, the plugin is called "TUFLOW" in the repository: <u> [https://docs.qgis.org/3.16/en/docs/training_manual/qgis_plugins/fetching_plugins.html Link to QGIS Documentation - Installing and Managing Plugins]</u>.<br> | ||
| Line 19: | Line 19: | ||
It's recommended to upgrade the plugin whenever a new version is released. The upgrade process is typically done via the Plugin Manager ('''QGIS Drop Menu: Plugins >> Manage and Install Plugins''').<br> | It's recommended to upgrade the plugin whenever a new version is released. The upgrade process is typically done via the Plugin Manager ('''QGIS Drop Menu: Plugins >> Manage and Install Plugins''').<br> | ||
[[File: TUFLOW Plugin Update.JPG||600px]]<br><br> | [[File: TUFLOW Plugin Update.JPG||600px]]<br><br> | ||
| − | If you encounter an error while upgrading the plugin please follow these steps: <u>[[ TUFLOW_QGIS_Plugin#Error_While_Upgrading_Plugin | | + | If you encounter an error while upgrading the plugin please follow these steps: <u>[[ TUFLOW_QGIS_Plugin#Error_While_Upgrading_Plugin | Error While Upgrading Plugin]]</u>. |
<br><br> | <br><br> | ||
==Opening the 1D Integrity Tool== | ==Opening the 1D Integrity Tool== | ||
| − | After installing the QGIS TUFLOW plugin, the TUFLOW | + | After installing the QGIS TUFLOW plugin, the TUFLOW 1D Integrity Tool can be opened by clicking the following icon in the plugin toolbar:<br> |
[[File: integrity_tool_in_toolbar.PNG]].<br> | [[File: integrity_tool_in_toolbar.PNG]].<br> | ||
| − | |||
=General Overview= | =General Overview= | ||
The 1D Integrity tool is designed to accept multiple inputs and will treat all inputs holistically as a complete system. Each tool is designed to be run separately and progressively as part of the entire tool suite. It is assumed that most of the channel attribute data has been populated, most importantly that each channel has been given a valid type.<br> | The 1D Integrity tool is designed to accept multiple inputs and will treat all inputs holistically as a complete system. Each tool is designed to be run separately and progressively as part of the entire tool suite. It is assumed that most of the channel attribute data has been populated, most importantly that each channel has been given a valid type.<br> | ||
| − | See [[#Tool_Documentation|Tool Documentation]] for information on each tool and [[#Example_Workflow_and_Tutorial|Example Workflow and Tutorial]] for examples. <br><Br> | + | See <u>[[#Tool_Documentation|Tool Documentation]]</u> for information on each tool and <u>[[#Example_Workflow_and_Tutorial|Example Workflow and Tutorial]]</u> for examples. <br><Br> |
| − | |||
| − | |||
<ol> | <ol> | ||
| Line 43: | Line 40: | ||
<li> '''Run''' - runs the currently active tool (active tool determined by the current active tool tab - prior to plugin version 3.2 a radio button was used to select the active tool). | <li> '''Run''' - runs the currently active tool (active tool determined by the current active tool tab - prior to plugin version 3.2 a radio button was used to select the active tool). | ||
</ol> | </ol> | ||
| − | |||
=Tool Documentation= | =Tool Documentation= | ||
| Line 55: | Line 51: | ||
=Example Workflow and Tutorial= | =Example Workflow and Tutorial= | ||
| − | + | * [[1D_Integrity_Tool_-_Tutorial|1D Integrity Tool Tutorial]] | |
| − | |||
=Planned Development= | =Planned Development= | ||
The following items are currently planned future developments: | The following items are currently planned future developments: | ||
| + | * Edit pipe attributes within the long plot | ||
* Auto correct continuity errors - use a set of rules to correct continuity errors | * Auto correct continuity errors - use a set of rules to correct continuity errors | ||
* Inference tool - tool to fill in missing data such as pipe inverts based on a set of rules | * Inference tool - tool to fill in missing data such as pipe inverts based on a set of rules | ||
| − | |||
=Errors= | =Errors= | ||
Latest revision as of 11:11, 8 August 2024
The 1D Integrity Tool is a suite of tools that help modellers find and fix potential errors in 1D networks prior to running TUFLOW. The tool was primarily designed for (large) underground pipe networks, but can be used for all 1D channel types, however not all checks will be available. The tool is designed to be fast and provide automated fixes as well as visualisations to help the process. The tool is undergoing constant development and a list of planned features can be found at the bottom of the page.
| Up |
|---|
 Back to TUFLOW QGIS Plugin Main Page
|
Getting Started
Installation or Version Upgrade
Installation
The 1D Integrity Tool is a free tool that comes as part of the TUFLOW plugin in QGIS. For instructions on how to install the plugin, please follow these steps: Installation of TUFLOW QGIS Plugin.
There are also instructions on installing plugins in the QGIS documentation - if you choose to follow the QGIS documentation, the plugin is called "TUFLOW" in the repository: Link to QGIS Documentation - Installing and Managing Plugins.
Plugin Upgrades
It's recommended to upgrade the plugin whenever a new version is released. The upgrade process is typically done via the Plugin Manager (QGIS Drop Menu: Plugins >> Manage and Install Plugins).
If you encounter an error while upgrading the plugin please follow these steps: Error While Upgrading Plugin.
Opening the 1D Integrity Tool
After installing the QGIS TUFLOW plugin, the TUFLOW 1D Integrity Tool can be opened by clicking the following icon in the plugin toolbar:
.
General Overview
The 1D Integrity tool is designed to accept multiple inputs and will treat all inputs holistically as a complete system. Each tool is designed to be run separately and progressively as part of the entire tool suite. It is assumed that most of the channel attribute data has been populated, most importantly that each channel has been given a valid type.
See Tool Documentation for information on each tool and Example Workflow and Tutorial for examples.
- Input Network Lines - input location of 1d_nwk lines such as pipes, culverts, and open channels. Use dropdown box and '+' button to add layers as inputs to tool.
- Input Network Points - input location of 1d_nwk points such as pits and nodes. Use dropdown box and '+' button to add layers as inputs to tool.
- Input Tables - input location of 1d_ta lines such as 1d_xs, 1d_cs, and 1d_hw. Use dropdown box and '+' button to add layers as inputs to tool.
- Input DEM - input raster. Currently only 1 input is supported, so if you are using tiled rasters datasets, they would need to be mosaiced into a single raster prior to running the tool.
- Tool Selection - the active tab will determine the active tool. Prior to plugin version 3.2 a radio button was used to select the active tool. See Tool Documentation for information on each tool.
- Status Bar - contains the progress bar and status of the integrity tool. Includes information such as the current active task being performed (if one of the tools is running), and the status of the previously run tool.
- Run - runs the currently active tool (active tool determined by the current active tool tab - prior to plugin version 3.2 a radio button was used to select the active tool).
Tool Documentation
Example Workflow and Tutorial
Planned Development
The following items are currently planned future developments:
- Edit pipe attributes within the long plot
- Auto correct continuity errors - use a set of rules to correct continuity errors
- Inference tool - tool to fill in missing data such as pipe inverts based on a set of rules
Errors
The tool will typically capture all errors that occur and the user may receive the following message box:
After the user closes this dialog, another one should open with the 'stack trace'. The 'stack trace' is a trace of the Python error that occured and is useful for finding and fixing the error. Copy the text and email it to support@tuflow.com with a copy of the inputs used in the integrity tool if possible.
Occassionally you may receive an uncaught error, appearing as a yellow banner at the top of the QGIS window. Similar to the above process, please select 'Stack trace' and email a copy of the text and (if possible) the inputs used in the integrity tool to support@tuflow.com.
