Calibration Time Series
The Calibration Time Series menu item provides several options using the RMC, including the options to configure the linkages with Define Calibration Series), plot data versus model with View Time-series Plot & View Correlation Plots, and generate a series of error measurements between model and data with Calculate Error Statistics. These options are described below.
Defining Calibration Series
The form used to link cells to data and other parameters is shown in Figure 1. Once configured, the linkages between the individual grid cells and the data are automatically available, and the user only needs to press the Time-Series Plots and Correlation Plots button to compare the model to data for each run. The user should enter the number of series that linkage will be created for, as well as the start and end time for the comparisons. Other options are described below.
Figure 1. Time series calibration EFDC cell and data linkage definitions.
There are several options on top of the grid table in the Model Calibration form. They are described in the table below.
Option | Description |
|---|---|
This is the copy option. LMC on a cell in the table below. When that cell is highlighted click this option to copy that cell. | |
This is the paste option. After using the copy option, LMC on another cell, then select this option to paste the information to that cell. | |
This is the insert row option which allows inserting a new row into the grid table. Select a row by LMC on a cell of that row, then select this option will add a new row. | |
This is the delete row option which allows removing selected rows from the grid table. Select a row or multiple rows, then select this option will remove selected rows. | |
This is the import calibration data file option, which allows loading the calibration data file (*.EE). Select this option, the Import Calibration Data form will be displayed as shown in Calibration Time Series#Figure 2, select the file, then click the Open button, the grid table will be updated. | |
This is the export calibration data file option, which allows saving the calibration data file (*.EE). Select this option, the Export Calibration Data form will be displayed as shown in Calibration Time Series#Figure 3, enter a name or use the default name for the file name, then click the Save button, the file will be saved out. | |
This is the line style setting option, which allows setting the lines style of observed and modeled lines in the time series plots. There are three options when clicking this button, as shown in Calibration Time Series#Figure 4. | |
This is the Information button. Click this button and the Enhanced Message Box will be displayed as described below. |
Defining the MMA
MMA stands for minimum, maximum, and average. After selecting this option, the Line Settings form will be displayed showing the default lines names as seen in Figure 5. Press the F2 key to see more details about this option (Figure 6). In this form, [N] is the station name, and [L] is the layer name. These shown in the Data Series box, and user-configurable. The Data Series settings here will be displayed in the legend of the time-series plots. Besides using default settings, we can manually define the settings. To do this, select each line in the Data Series frame, then enter the new name for the Title in the Series Information frame. Click the OK button to apply these settings. For example, the user could change it from the default "[N] - Model, Layer Avg" to "[N] - Model ABC, Layer Avg," or from "[N] - Data" to "[N] - Observed)."
Defining Layers
After the Define Layer option the Line Settings form will be displayed and the default lines names shown as in Figure 7. Pressing the F2 key also provides information help for this form. Again, [N] is the station name, [L] is the layer name as described above. The Data Series settings here will be displayed in the legend of the time series plots. Besides using default settings, we can define the settings by ourselves by selecting each line in the Data Series frame then entering a new name for the Title of the Series Information frame then click the OK button (e.g [N] - Model, [L] → [N] - Model ABC, [L]; [N] - Data → [N] - Observed). We also can set the line style and color from the Line Formatting frame.
Apply User Defined Settings
The Apply User Defined option allow the user to set and apply their own line style options instead of the EE default line settings. After configuring the Define MMA and Define Layer options, in order to use those settings it is necessary to check the checkbox for Apply User Defined selected. The data series settings displayed on the legend of the time series plots will be applied to what was previously defined .
For each model-data pair, the user must specify the information listed in each column:
Name:The ID field is used for labeling the plots and statistical reports.
X & Y: Enter the X and Y in meters of the location of the data station. The coordinate system must be the same as that used for the model. Using these coordinates the matching model cell is determined. User can check the coordinates by clicking on Get I & J button in Figure 9 that allows the user to input X and Y values in the LXLY units to determine the corresponding values of I & J.
Layer: This is the layer specification option. There are three options as shown. The Min-Avg-Max (MMA) option generates three model time series for the cell, based on the water column layer results.
H (m): The depth or elevation specified if the selected layer option is Fixed Depth or Fixed Elevation.
Parameter: Select the parameter that will be extracted from the model for comparison to the data contained in the corresponding data file in Figure 9. Or user can type the parameter code in Param column in Time Series Comparisons form (Figure 1) based on the list of currently available parameters shown in Figure 10. To show the parameter code as shown in Figure 10, the user clicks on the Information button (
) on the top of the table frame in Figure 9. Table 1 summarizes all parameter codes.
Data File: This field contains the full path to the data file, in DAT or WQ formats, for the specific parameter, location, and layer option. The user can leave this field blank to only display a model time series. Rows shown in pink indicate path names that are not valid (e.g. files were deleted by the user after initial setup) and need to be redefined. If the model path of the data has changed, highlight the cells in the column to be changed and use the CTRL+H keystroke to search and replace part of the path to update it.
Group: This is the plot number. If each line uses a unique Group # then each model-data pair will be displayed on a separate plot. If two or more model-data lines use the same Group # they will be displayed on the same plot.
Use: This is a flag to optionally turn on or off the plots and statistics computation for each model-data pair.
Other options included:
Time Tolerance is used to set the time tolerance in minutes, such that there is a time match when the MODEL_TIME is within the DATA_TIME +/- tolerance.
Julian Date Offset is used when Julian dates have been used in the data files rather than Calendar dates. This offset allows the user to add this number of whole days to the Julian dates
Reload Model Output checkbox is used to reload the model result in case of re-simulation of the model.
Note that if a link is incorrectly configured and the file cannot be found at that pathname it will appear with a red highlight.
When first starting with the model-data linkage process, the Number of Time Series field will be "0". To initially define or add/remove linkages, enter the number of desired linkages. When the user presses "Enter" the data grid will display the number of lines required. The number of model-data linkages can be changed at any time. However, the definitions above the maximum number of linkages will be deleted.
Right mouse click on the cells to obtain Station Information form to define model parameters and data series file paths as shown in Figure 9.
Figure 9 Station Information definitions.
Figure 10 Calibration parameter codes.
Water Layer |
|
|---|---|
0 | Depth Average |
-6 | Min – Average - Max |
1 to KC | By Layer |
-2 | Fixed Depth |
-3 | Fixed Elevation |
-4 | Withdrawal/Return |
Parameter Code |
|
99 | Disabled |
-1 | Water Surface Elevation |
0 | Water Depth |
1 | Salinity |
2 | Temperature |
3### | Dye (# Class Number, e.g. 3001) |
5#,# | Toxics (# Class Number e.g. 51, 50-All Toxics), #Toxic Options: 0: Total 1: Toxic Dissolved Toxics 2: DOC Complexed 3: POC Bound 4: DOC 5: POC 6: FOC (Fraction of Organic Carbon) 7: Tox (Dissolved+ DOC Complexed) |
6# | Solids (# Class Number, e.g. 61, 60-TSS) |
1# | Velocities |
11 | XY Magnitude |
12 | X Component |
13 | Y Component |
14 | Z Component |
15 | XYZ Magnitude |
16 | Direction |
800, #, # | Biota Concentration (800, # Class Number, # Unit Options) |
| # Class Index: 0: Total Phytoplankton, -1: Total Attached # Unit Option: 0: mg C/L, 1: ug Chl-a/L |
801, #, # | Water Quality Biota Density |
| Biota Density (801, # Class Number, # Unit Options) # Class Index: 0: Total Phytoplankton, -1: Total Attached # Unit Option: 2: g C/m², 3: mg Chl-a/m², 4: g Biomass/m² |
802, #, # | Water Quality Biota Growth Factors |
| Biota Density (802, # Class Number, # Options) # Option: 0: Net Growth Factor 1: Light Limitation 2: Temperature Limitation 3: Limiting Nutrient: P or N 4: Phosphorous Limitation 5: Nitrogen Limitation |
803, #, # | Water Quality Zooplankton |
| Zooplankton (803, # Class Number, # Option) |
804 | Refractory POC |
805 | Labile POC |
806 | Dissolved Org Carbon |
807 | Refractory POP |
808 | Labile POP |
809 | Diss. Org Phosphorus |
810 | Total Phosphate |
811 | Refractory PON |
812 | Labile PON |
813 | Diss. Org Nitrogen |
814 | Ammonium Nitrogen |
815 | Nitrate Nitrogen |
816 | Part Biogenic Silica |
817 | Dissolved Available Silica |
818 | Chemical Oxygen Demand |
819 | Dissolved Oxygen |
820 | Total Active Metals |
821 | Fecal Coliform |
822 | Carbon Dioxide |
| Derived Water Quality Parameters |
824 | Total Organic Carbon |
825 | Total Nitrogen |
826 | Total Phosphorus |
|
|
828 | Total Organic Nitrogen |
829 | Total Inorganic Nitrogen |
830 | Total Organic Phosphorus |
|
|
849 | Trophic State Index |
850 | Particulate Org Carbon |
851 | Particulate Org Phosphorus |
852 | Particulate Org Nitrogen |
853 | TSS (Inorg + Org) |
854 | Total Kjeldahl Nitrogen |
855 | Total Dissolved Phosphorous |
857 | Water Density |
858 | WQ Zone |
| RPEM Parameters |
896 | Shoot Carbon (gm C/m^2) |
897 | Root Carbon (gm C/m^2) |
898 | Epiphyte Carbon (gm C/m^2) |
899 | Detritus Carbon (gm C/m^2) |
| Ice Parameters |
901 | Ice Thickness |
902 | Ice Temperature |
| Diagenesis Parameters |
910 | Conc PON (g/m^3) |
914 | Conc POP (g/m^3) |
918 | Conc POC (g/m^3) |
922 | Conc NH4-N (g/m^3) |
925 | Conc NO3-N (g/m^3) |
928 | Conc PO4-P (g/m^3) |
931 | Conc H2S (g/m^3) |
934 | Conc Silica (g/m^3) |
938 | Benthic Stress (days) |
939 | Sed Temp (deg) |
943 | PON Flux (g/m^2/day) |
944 | POP Flux (g/m^2/day) |
945 | POC Flux (g/m^2/day) |
946 | NH4 Flux (g/m^2/day) |
947 |