Building a WASP Model

This guidance is based on the assumption the user has a correctly configured and running EFDC+ hydrodynamic and temperature model. From this model the user will be guided on how to configure EEMS to export the required files for WASP7/8 water quality simulations. The model used in this example can be run in demo mode of EEMS, and may be downloaded from here.

Generate WASP linkage file (*.hyd) from EFDC+

The first step is to generate a hydrodynamic linkage file (*.hyd) for use in the WASP model. From the Model Control form, go to the Timing/Linkage tab, as shown in Building a WASP Model#Figure 1.

Figure 1. WASP Linkage Output Setting from EE.

From Timing/Linkage tab:

(1) RMC on Linkages sub-tab;

(2) From EFDC Model Linkages form, go to WASP Linkage tab;

(3) Select WASP radial under Linkage to Water Quality Model frame, then select WASP8HYDRO from the drop-down list;

(4) Type in 10 to Number of Minutes to Average per Linkage Step box to set the output frequency of the linkage file. In this case, the wasp linkage output will be saved per 10 minutes.

(5) Click OK button to save the setting

In the model interface, click on Save to save the model, as shown in Building a WASP Model#Figure 2, below.

Figure 2. Save Button in the Model Interface.

After clicking on the Save button, a Select Directory: Write Operation a pop-up will appear to select saving options (refer to Building a WASP Model#Figure 3). Before project files are saved, the grey box is empty. This is where EE project files will be listed. The empty gray box shows that no files have been written yet for the study, as shown in Building a WASP Model#Figure 3.

Three save options are offered in the Save Options frame of Building a WASP Model#Figure 3:

Full Write can be selected to save all the input files,
Write All except Time Series Files can be selected to save all input files without the time series.
Save Profile File Only (EFDC.EE) can be selected for saving if the user has only changed formatting options in EE.

In this project, the Full Write option is recommended. After choosing this option, click OK to close the form and save the model.

Figure 3. Saving the model.

To run the model, follow the steps below, as shown in Building a WASP Model#Figure 4.

Click on the Run EFDC+ button at the top of the model interface to run the model. The EFDC+ Run Options form will appear; Building a WASP Model#Figure 4. in this form, under the General tab, set the Number of OMP Threads to use for the EFDC+ run in the EFDC+ Multi-Threading frame. Note that the number of threads used for the EFDC+ run must be smaller than the total number of threads.

Also, in the EFDC+ Multi-Threading frame set the KMP Offset to set the threads that will be passed over when running the model. For example, if KMP Offset is set to 2, which means the thread used for the EFDC+ run will start from the 3^rd thread. This can be used to run multiple models on one machine, so the models run on different threads.

Note: If the model has existing results, please check the Overwrite check box to run and save new results.

Figure 4. EFDC+ Run Options form.

Click on the Run EFDC+ button to start running the model. A run window such as that pictured in Building a WASP Model#Figure 5 will appear.

Figure 5. EFDC+ run window.

After the EFDC+ model run is finished, the user should browse to the output folder to make sure that the efdc_dsi_wasp.hyd file has been generated. It should be noted that the WASP8SEG_EFDCIJK.DAT file allows the identification of the corresponding segment between the WASP and the EFDC cell.

Figure 6. WASP Linkage file generated by EFDC+.

Building WASP model with using Hydrodynamics Linkage

From the WASP program interface, click on the New button in the toolbars to create a new project

Figure 7. Create a new WASP project.

After creating a new project, click on the Data Set button, which is now enabled in the toolbar, then carry out the following steps to link hydrodynamic input:

(1) Check on Hydrodynamics checkbox, then browse to the efdc_dsi_wasp.hyd file generated from EFDC+;

(2) Select the Solution Technique as Cosmic ;

(3) Modify the Model Output Interval for the output frequency;

(4) Click the OK button to save the setting (Building a WASP Model#Figure 8).

Figure 8. Link hydrodynamics output from EFDC+ to WASP model.

The next step when setting up a new WASP is to check at this point if the data provided by EFDC+ hydrodynamic linkage file are read correctly by WASP8. User can also check the numerical stability of the hydrodynamic linkage by inspecting the “Mass Check” system on the runtime and in model output.

For WASP 8 the output is not turned on automatically, so the user must go to the Output Control button from the toolbar to select the output parameters that will be written out.

(1) Click on the Output Control button from the toolbar

(2) Check on the output checkboxes for Mass Check, as well as the transport quantities that user wants to write out to compare with the EFDC+ model.

(3) Click the OK button to save the setting (Building a WASP Model#Figure 9).