TuPlot: Difference between revisions

Content deleted Content added
No edit summary
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 5:
* .tpc (<u>T</u>UFLOW <u>P</u>lot <u>C</u>ontrol file links to data in csv and gis folders
* Has additional Node and Channel information files contain connectivity information
This is the default approach for the 2016 version but can be modified with the TUFLOW command "<tt>Output Approach == Pre 2016</tt>" (refer to the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u> for more information on this command.
<br>
The TuPlot utility is currently available as part of a QGIS plugin, however, future plans include extending this to ArcMap and as a standalone viewer.
 
=Instalation=
=Installation=
TuPlot is contained within the [[TUFLOW_QGIS_Plugin | TUFLOW QGIS Plugin]]. Refer to the [[TUFLOW_QGIS_Plugin | Plugin]] page for installation details.
 
=TUFLOW Python Results Library=
The TuPlot plotting utility relies on a python library '''TUFLOW_results2016.py''' for loading the TUFLOW results. This python based library can also be used to access TUFLOW results from python (outside of TuPlot). Please refer to [[Python_Library_TUFLOW_Results_2016Python_Library_TUFLOW_Results | python TUFLOW results library]] for more information and examples of this.
 
=QGIS TuPlot=
This plotting functionality is currently accessed via QGIS. Ensure that the QGIS plugin is installed via the instructions <u>[[TUFLOW_QGIS_Plugin | on the TUFLOW QGIS plugin page]]</u>.<br>
Once this has been installed successfully QGIS can be open and the plugin accessed via the '''Plugin >> TUFLOW >> TuPlot''' menu item, or via the TuPlot button in the toolbar. The toolbar icon is shown below.<br>
[[File:TuPlot Icon 01.JPG]]
Line 51 ⟶ 52:
<li>matplotlib toolbar - this contains options for changing the zoom and customising the plot window.</li>
<li>Selected elements view. This contains a list of the ID's of the selected elements (1D, 2D or RL). This is for display only. Changing the selection here does not alter the plot</li>
<li>Time step selection. This is only valid for '''Long Profile''' viewing, see [[TuPlot#Long_Profiles | Long Profiles]] below</li>
<li>Status dialogue. This contains information on the status of the TuPlot utility. If there are any warnings or errors these should be displayed in the status window.</li>
<li>Clear Status. This can be used to clear previous messages to the status dialogue</li>
Line 93 ⟶ 94:
 
===Multiple Results Files===
Multiple results files can be opened, see [[TuPlot#Loading_Results | Loading Results]] above.<br>
In the image two results files have been opened (the 1st using '''Add Res + GIS''' and the second with the '''Add Results''' button. These are:
* M02_5m_001_LowN - A low Manning's n case of Tutorial Module 2 with Manning's decreased by 20% with the .tcf command "<font color="blue"><tt>Read Materials File </tt></font> <font color="red"><tt>==</tt></font><tt> ..\model\materials.csv | 0.8 </tt><font color="green"><tt>!Decrease Roughness by 20%</tt></font>"
Line 122 ⟶ 123:
[[File:TuPlot LongProfile 02A.PNG]]
===Animate Long Profile===
The TuPlot utility can save out a series of images (in the .png format) of each of the timesteps in the long profile data. These are saved out to the .tpc folder and are given a sequential number. These can be converted into a video using software such as Windows movie maker or ffmpeg. Future versions of TuPlot will look to create the animations from the images automatically.<br>
[[File:TuPlot LongProfile 03.PNG]]
 
==Plotting 1d_ta (tabular data)==
To plot 1d tabular data (1d cross sections, 1d losses, 1D nodal area), the step in TuPlot are:
* Open the relevant 1d_xs or 1d_ta GIS layer. This should be in the format outlined in the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW manualManual]</u>.
* Select feature(s) to plot
This workflow is shown in the image below.<br>
[[File:TuPlot TabularData 01A.PNG]]
<br>
If the cross-section has roughness data (the '''Flags''' attribute includes '''M''' [material ID] or '''n''' [Manning's n]) this can be visualised by navigating to the options tab and checking the box for '''Display Roughness''' (see [[TuPlot#TuPlot_Window | TuPlot window]] above). An example is shown in the image below.<br>
 
[[File:TuPlot TabularData 02.PNG]]