TUFLOW Viewer - Importing a User Defined Time Series To Display On The Plot

From Tuflow
Revision as of 13:27, 2 June 2021 by Chris Huxley (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Tool Description

It's possible to import external data into the plotting window(s) to display alongside plotted results. This can be useful, for example during model calibration testing when comparing model results against gauge recordings.

Steps to import data:

  1. Open the User Plot Data Manager via the Settings Menu
    Plotting User Plot Data Manager.PNG
  2. Select Add Data
  3. Use the import wizard to pass in text data:
    1. Delimiter File - File containing the data to be imported.
    2. Delimited Format - Character / symbol delimiting the data.
    3. Number of Header Rows to Discard - The number of rows at the top of the file to ignore.
    4. Use Header Line as Data Labels - Uses row values as labels for the imported data series. This can be changed later after the import is complete. The user must choose which header row to use as labels if more than one is available.
    5. X Column / Y Column - Column containing the X and Y values. User can choose multiple Y columns.
    6. Null Value - Value to be treated as null. Note, blank values will always be treated as null.
    7. Convert From Date Format - This step is required if the X data is in date format. This step will convert the date format to a relative time.
    8. US date format - Tick this box on if the tool is interpreting month and day incorrectly. Generally this will be dependent on the input format and the computer settings.
    9. Manually Specify Zero Date Time - Input a reference time for conversion to relative time. If left blank, the tool will use the first valid (non-null) entry as the reference time. Plotting User Plot Data Import Wizard.PNG
  4. Review the preview - click OK when ready.
  5. Specify which plot tab to plot the data to:
    Plotting User Plot Data Manager PlotType.PNG
  6. Click OK.


It is possible to review the data in the User Plot Data Manager by selecting the data in the table and selecting either:

  • View Data - Will display the data in a table. It is possible to edit the data in the table, however it won't be a very efficient method of bulk editing as this feature has not been created for this purpose. It's probably easier to do editing in Excel / Python etc. and re-import once the changes have been made.
  • Plot Data - Will display the data as a plot.

It is possible to change the dataset name, toggle the visibility of the data, or remove the data in the User Plot Data Manager.

Example

Plotting User Plot Data Import Example.gif

Up
Go-up.png Back to TUFLOW Viewer Main Page