Tuflow

TUFLOW Viewer: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(15 intermediate revisions by 5 users not shown)
Line 2:
<br>
__TOC__
 
 
 
=Getting Started=
Line 20 ⟶ 18:
* Post QGIS 3.14 TUFLOW Viewer stores all results internally as absolute time and the user must change the reference time in the native properties of the mesh layer to alter the dates being displayed. '''Zero Date''' now only changes how the relative time is displayed in TUFLOW Viewer and doesn't change the mesh layer reference time.
* Please follow the link below on how to use isodate (date-time) format in TUFLOW Viewer in QGIS 3.16+ (recommended minimum version if using date-time format): <u>[[TUFLOW_Viewer_-_Isodate_(Date-Time)_Format | Working With Isodate (Date-Time) format]]</u>.
</ol><br>
 
'''Other Known Issues'''<Br>
Line 35 ⟶ 33:
===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''').<br>
<br><Br>▼
[[File: TUFLOW Plugin Update.JPG||600px]]<br><br>
[[File: TUFLOW_Plugin_Update_01.png]]<br><br>
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>.
 
==Development Version==
It's possible to test out the latest development version of the plugin and TUFLOW Viewer by following the instructions belowhere: <bru>[[Installing_the_Latest_Development_Version_of_the_TUFLOW_Plugin | Installing the Latest Development Version of the TUFLOW Plugin]]</u>.
<b><u>[[Installing_the_Latest_Development_Version_of_the_TUFLOW_Plugin | Installing the Latest Development Version of the TUFLOW Plugin]]</u></b>
▲<br><Br>
 
=Using TUFLOW Viewer=
==Opening the TUFLOW Viewer==
After installing the QGIS TUFLOW plugin, the TUFLOW Viewer tool can be opened by clicking the following icon in the plugin toolbar:<br>
<br>
[[File: TUFLOW_Viewer_In_Toolbar.PNG]].<br>
[[File: TUFLOW_Plugin_Toolbar_TUFLOW_Viewer_01.png]]<br>
 
==Loading Results==
TUFLOW simulation results can be loaded severaltwo ways:<br>
<ol>
<li> Select '''File >> Load Results''' from the TUFLOW Viewer drop down menu.<br>
<br>
[[File:TUFLOW Plugin Load 1.jpg||800px]]<br>
[[File:TUFLOW_Viewer_Load_Results_01a.png]]<br>
<br>
<li> Right Click in the '''Open Results''' panel and select '''Load Results'''.<br>
<br>
[[File:TUFLOW Plugin Load 2.jpg||800px]]<br>
[[File: TUFLOW_Viewer_Load_Results_02a.png]]<br>
<br>
</ol>
Using either of the above methods, the following result load options are available:
<ol>
<li> <u>'''[[TUFLOW_Viewer_-_Load_Results | Load All Results]]'''</u> --> This is done via a TCF, TLF, or FVC (TUFLOW FV)TLF file and will load in all results (Map Outputs and ESTRY Time Series). ''Note: the Load All Results feature is not yet enabled for TUFLOW FV FVC files.''
<li> <u>'''[[TUFLOW_Viewer_-_Load_Results_-_Map_Outputs | Load Results - Map Outputs]]'''</u> --> Select map output mesh results file ('''*.xmdf, *.dat, *.2dm, *.xmdf.sup, *.dat.sup, *.nc''' ''(supports netCDF format from TUFLOW FV output only)'').
<li> <u>'''[[TUFLOW_Viewer_-_Load_Results_-_Time_Series | Load Results - Time Series]]'''</u> --> Select ESTRY / SWMM time series output results ('''*.tpc *.gpkg''').
Line 68 ⟶ 70:
<li> <u>'''[[TUFLOW_Viewer_-_Import_1D_ESTRY_Cross_-_Sections | Import 1D ESTRY Cross-Sections]]'''</u> --> This will automatically happen if an appropriate TUFLOW input is opened in QGIS while TUFLOW Viewer is open (e.g. 1d_xs).
<li> <u>'''[[TUFLOW_Viewer_-_Importing_a_User_Defined_Time_Series_To_Display_On_The_Plot | Importing a User Defined Time Series Dataset To Display In The Plot Window]]'''</u>
<li> <u>'''[[TUFLOW_Viewer_-_Import_FV_Tide_BC_NetCDF | Import FV Tide BC NetCDF]]'''</u>
<li> <u>'''[[TUFLOW_Viewer_-_Loading_Results_While_TUFLOW_is_Running | Loading Results While TUFLOW is Running]]'''</u>
</ol>
 
'''===Troubleshooting'''<br>===
If you receive an error similar to that shown below when attempting to load results from a TCF you will need to fix the encoding of your TUFLOW control files:<br>
<pre>
UnicodeDecodeError: 'utf-8' codec can't decode byte 0x92 in position 626: invalid start byte
</pre>
This error is caused by incompatible encoding of the TUFLOW control files. You can resolve this issue by changing the encoding of all your TUFLOW control files to a single type (typically UTF-8). You can do this using Notepad++. Please see the following link for instructions on how to do this (refer last image): <u>[[TUFLOW_Message_0060 | TUFLOW Message 0060]]</u>.<br>
 
== TUFLOW-SWMM Results ==
Results from a linked TUFLOW-SWMM model can be loaded via the standard menu options (available from the TUFLOW plugin version 3.10):
* <u>'''[[TUFLOW_Viewer_-_Load_Results_-_Time_Series | Load Results - Time Series]]'''</u> toTo load the GPKG time series format (_swmm_ts.gpkg) by itself. The GPKG time series format is a new format similar to the .tpc with some additional functionality. More information can be found in the <b><u>[[#GPKG_Time_Series_Format | GPKG Time Series Format]]</u></b> section.
* <u>'''[[TUFLOW_Viewer_-_Load_Results_-_Map_Outputs | Load Results - Map Outputs]]'''</u> toTo load in 2D map output results
* <u>'''[[TUFLOW_Viewer_-_Load_Results | Load Results]]'''</u> toTo load all available results from the model. This includes .xmdf, .tpc, and .gpkg results which could all be available for a given model run. Note that .tpc and .gpkg are both time series type results and will load separate GIS _PLOT_ layers.
 
== GPKG Time Series Format ==
Line 187 ⟶ 190:
<br>
 
==Exporting Animations, Data, Plots, Maps and AnimationsMaps ==
TUFLOW Viewer offers the ability to export animations, data interegation points/lines, maps, plots and animationsplots:<br>
<ol>
<li> <u>'''[[TUFLOW_Viewer_-_Exporting_An_Animation | Exporting An Animation]]'''</u><br>
Retrieved from "https://wiki.tuflow.com/TUFLOW_Viewer"