Data Series Editing Form

Owned by Kester Scandrett
Last updated: 14 Dec, 2017

A common function needed for all the boundary forcing data series is the need to edit, view and compare these series. These processes and other time series utilities are available using the Data Series time series data management form (Figure 1). This form will vary to some extent depending on the boundary condition data series being edit. It is broken down into several sections which are outlined below.

The Title Block displays and allows edits of the title block EFDC requires for the specific boundary file(s). The number of lines varies between boundary forcing files. EFDC_Explorer ensures the correct number of header lines is used for each type of file. Pressing Reset will overwrite the current header with a "standard" header for that type of file, using the Project Title as the project specific label. The user may also manually edit the header and EFDC_Explorer will maintain those edits. However, only one header is available for all the different series.



Figure 1 Data Series Editor: WQ boundary conditions.


Sometimes, the type of data series has fixed groups for a given series. This is the case for sediments, toxics and water quality. To view and/or edit a series the user must specify the series (e.g. "1" in Figure 538) and a group (e.g. "4" for Refractory Organic Carbon). The user can then edit, plot, compare, copy, etc. the currently selected series/group. If the type of series does not use groups (e.g. flows) then the group frame will not be displayed.

The View Series frame provides the user with the ability to plot the time series. The More button provides access to additional plotting functions. The Show All Series button compares already defined series to each other. The user can turn on or off the series by selecting 1 or 0 for each series as shown in Figure 2 The Filters frame includes Daily Minimum and Daily Maximum. This allows the user to show any series the user selects on the same plot for the selected parameter in a given column (Y Col), also shown in Figure 2.



Figure 2 Data Series Editor: View Series options.


The option buttons for Editing Tools and File Tools change the function of the frame below these buttons. The Editing Tools is the default frame. This option allows the user to apply Operator's to the date column or any/all of the data columns, or a range of columns. The user may enter the column number, or if they want the operator to apply to layers from 1 to 3, then they should enter "1-3" in the Apply to Y's input interface. This will apply the operator to these layers for the whole time series. Entering "-1" will apply the operator to all columns and a "P" in front of this will apply to parameters instead of layers.
The following is a description of the various "Editing Tools" functions:

  • Copy  To copy the current series to a new series at the end of the current list of series.
  • Add  Adds a specified series to the current series. This process overwrites the current series with the results. The timing does not need to match. EFDC_Explorer uses the current series' timing and computes the value of the second series at the times of the current series.
  • Delete  Deletes the current series. All the series number above the current series are renumbered to the next lower number and boundary conditions that use these series are updated.
  • BreakPt  This function "breakpoints" the current series. The breakpointing process removes consecutive points that have the same value (within a user specified tolerance), leaving the 1st and last points with the same value. An example of a series breakpointed is shown below.

  • Smooth  Applies a smoothing process to the current series. The weights are 1/6, 2/3 and 1/6. A single pass is applied. The user can apply the smoothing repeatedly to attain the desired smoothing. Since the current series is overwritten with the results of the smoothing process, it is useful to export (via the Time Series plotting function) the unsmoothed time series first. As smoothing is applied, the user can import (via the Time Series plotting function) the original series for comparison.

In the Series form there is now also a dropdown menu with a list of boundary conditions that may be selected from as shown.

Note that the time series form has several additional keystroke functions not available on the main form. Figure 3 shows a screen capture of the information message box (F2).



Figure 3 Time series keystroke function information message

Figure 4 File Tools Option


The File Tools option (see Figure 4) changes the frame to that shown here. The purpose of this option is to provide ways to populate the time series from existing data files. In addition to importing data from existing files, the user can paste data into the time series from another application (e.g. Excel) as long as the formats are compatible.

  • Merge Series  Imports an existing ASCII data file and then interpolates the data series onto the timing of the current series. This is especially useful for time series that have multiple groups for the same series (i.e. sediments, toxics, and water quality). Figure 541 shows an example of the ASCII data time series import form.
  • Import Data  Imports an existing ASCII data file and replaces the current series data with the new data. The same import form (Figure 5) used for the "Merge Series" is used for this function.
  • Import  Imports an existing EFDC formatted time series for the current time series type (i.e. if editing flows, will import a QSER.INP file). All the currently defined series for the current boundary type are overwritten with the contents of the import file.
  • Save As  Allows the user to write all of the series of the current boundary type to an EFDC formatted file. EFDC_Explorer writes these files during the project save process. However, this function is useful for backup during the editing process or to provide output for other user needs.

Figure 5 ASCII data time series import form.

The following provides a quick guide to the use of the ASCII data import form:

  • Select the data file to import using the Browse button.
  • Select the delimiter.
  • Depending on the Data Format selected, other options will also need to be selected in the Delimiter and Import Settings frames. .
  • The Data Column to Import should point to the column number that contains the Y data.
  • As changes are made the information in the First Line Results of Importing frame provides the results of the current settings.
  • Preview/Graph the results of the current settings to see if the import results are what was expected. If not, make further adjustments, as needed, until the data import plot is correct.
  • Press OK to finalize the actual importing process.

The editing form for data series for open boundaries is shown in Figure 6 below. This editor allows the user the option of using a choice of linear interpolation or spline interpolation for the PSER series. Linear interpolation has been the default option in EFDC. Using the spline option allows the PSER series to be smoothed. If linear interpolation is used it can cause sharp breaks in the series and leads to instability in the model. A spline interpolation avoids this issue. Clicking the A button will apply the time interpolation currently select to all the series.

The Generate From Harmonics option is described in Harmonic Tidal Boundary Series. The Hi/Lo and Single options allow the user to select from low and high pressure series, or a single water level series respectively.

Figure 6 Data Series Editor: Open boundary conditions.