TuPlot: Difference between revisions
Content deleted Content added
No edit summary |
No edit summary |
||
Line 48:
<li>List of available results types to be plotted on the primary Y axis</li>
<li>List of available results types to be plotted on the secondary axis</li>
<li>Animate LP. Start an animation of the Long Profile data. There must be data loaded and the Plot Type (8) above should be set to Long Profile</li>
<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>
<li>Update plot, if the options or results types have been modified, this button can be used to redraw the plot window</li>
<li>This is the plot window containing the time-series, long profile or cross-section plot</li>
The following features are available in the '''Options''' tab. After changing any of these settings, you will need to select the '''update Plot''' or change the selection in the QGIS map window to force a re-draw of the plot window.
<li>Deactivate viewer can be used to temporarily disable the TuPlot window, so that changing the selection, active layer will not cause the plot window to update</li>
<li>Show legend - toggle the legend on or off for the plot. The default is off</li>
<li>Display Roughness - this is only valid for viewing cross-sectional data. If the cross-section has varying roughness (M or N flag specified on the section) this will display the roughness information on a secondary y axis</li>
<li>Force Cross-section layer. When a TUFLOW cross-section layer is input into TUFLOW, it has the attributes Source, Type, Flags, Column_1, Column_2 etc. When the TuPlot utility encounters a map layer, it searches for these attribute names to determine if the layer is a 1d_tab or 1d_xs layer. If it is not, plotting for the layer is disabled. By enabling this check box, the checking of the layer attributes is suppressed. This will attempt to plot the data regardless of the attributes, however, if the data is not a valid 1d_tab format this may cause issues / errors with the plotting. For example if the 1st attribute is not a source .csv file, the utility will be unable to open this and read the content.</li>
<li>Force Results Layer. When determining if the GIS file selected in the layer control is a TUFLOW output file, TUFLOW checks that the attribute names match the output format from TUFLOW. Each of the GIS layers referred to in the .tpc file has three attributes: ID, Type and Source. By enabling this check box, the checking of the layer attributes is suppressed. This will attempt to plot the data regardless of the attributes, however, if the data is not in valid format this could cause issues with TuPlot.</li>
</ol>
==Loading Results==
In order to be able to visualise the results these results need to be loaded into the Plugin. This can be done with the '''Add Results''' or '''Add Res + GIS''' buttons. The difference between these is:<br>
* Add Res + GIS will load all the .csv file data into memory and also add the GIS layers to the current QGIS project. These are defined in the .tpc as:
:: <tt>GIS Plot Layer Point == .\gis\<filename>_PLOT_P</tt><br>
:: <tt>GIS Plot Layer Lines == .\gis\<filename>_PLOT_L</tt><br>
This is the preferred approach for reading in a single results file.
* Add Results will only load in the .csv files and not the GIS data. This can be used if a set of results is already open to avoid duplication of GIS layers in the project.<br>
After a set of results, with GIS files has been loaded, the QGIS window will look like the below:<br>
[[File:TuPlot Results Loaded.PNG]]
<br>
The layer window shows that two GIS layers have been loaded, these contains points (1D nodes, 2D plot output and reporting location points) and lines (1D channels, 2D plot output and reporting location lines).
==Time-series==
The default plot type for viewing results is Timeseries. Once results have been loaded (as per the above), select the GIS layer to plot from, the points and the lines contain different data:<br>
The _P (points) contains 1D node and 2D plot output / reporting location point data. This is typically water or energy level, depending on the output setting for the simulation.<br>
The _L (lines) contains 1D channels, 2D plot output and reporting location lines. This may include flows, velocities and flow areas depending on the output setting for the simulation.<br>
Once a GIS layer has been chosen, the '''Select Features''' tool can be used to select features in the map window. Multiple features can be selected by holding the 'control' key and click again, or by dragging a rectangle around multiple features.<br>
Once a feature(s) has been selected, the data will be plotted. The results types list can be used to select the type of data. Multiple results types can be selected.<br>
<br>
The annotated image below, shows the workflow.<br>
[[File:TuPlot Timeseries 01A.PNG]]
==Long Profiles==
=Plotting 1d_ta (tabular data)=
| |||