Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

1 Introduction

2 Create a New Grid

3 Assigning the Initial Conditions

3.1 Assigning the Initial Bottom Conditions

3.2 Assigning the Depth/Water Surface Elevations

3.3 Assigning the Bottom Roughness

4 Assigning the Boundary Conditions

4.1 Preparing the Flow Boundary

4.2 Preparing the Tidal Level Boundary

4.3 Assigning Time Series to the Boundary Location Cells

4.3.1 Assigning the Flow Boundary

4.3.2 Assigning Tides Boundary

5 Hydrodynamics Settings

6 Setting Vertical Layers

7 Model Timing

8 Running EFDC+

9 Visualizing the EFDC Solution


Anchor
TOC1
TOC1
1 Introduction

This tutorial document will guide you how to setup a coastal hydrodynamic model by using the EFDC_Explorer (EE). It will cover preparation of the necessary input files for the EFDC model and visualization of the output by using the EFDC_Explorer (EE) Software.

The data used for this tutorial are from Tra Khuc Estuary in Vietnam. All files for this tutorial are found in Data folder downloadable from the EEMS website.

Before going to each session, let us first introduce the EE main form in order to better understand our explanation hereafter. 2381073 Figure 1 is the main form of EFDC_Explorer or EE User Interface. The functions of individual icons are described in Knowledge Base.

Anchor
Figure 1
Figure 1

Figure 1  EFDC Explorer main form.



Anchor
TOC2
TOC2
2  Create a New Grid

This section will guide you in how to create a new simple gird with EFDC_Explorer. For a complicated grid the user is recommended to use specialized grid generation software such as CVLGrid.

Tra Khuc Estuary in Quang Ngai province, Vietnam is chosen as the example of building a 3D coastal model in EE.

The gird generation process includes following steps:

  1. Open EE
  2. Click Generate New Model icon as  on the main menu of EE interface. Then Generate EFDC Model frame appears shown in 2381073Figure 2
  3. Select CVLGrid in the Grid Type. The user should click the Browse button to select grid file name as Trakhuc.cvl in Grid folder sas as shown in 2381073 Figure 2.  In the other hand, EE also supports the user to import various format of grid file with the option Import Grid.
  4. Click Generate button in 2381073 to Figure 2 to finish. A dialog will pop up to show the grid information (see 2381073see Figure 3).

Anchor
Figure 2
Figure 2

Figure 2  Generate EFDC Model form.

Anchor
Figure 3
Figure 3

 

Figure 3  New created grid information.


    5. Save the model by selecting this button  and create a new directory as shown in 2381073 Figure 4.

Anchor
Figure 4
Figure 4

Figure 4  New model saved.


Anchor
TOC3
TOC3
3  Assigning the Initial Conditions

This section will guide you in how to assign the initial conditions such as the bathymetry, water level and bottom roughness.

Anchor
Figure 5
Figure 5

Figure 5  Assigning the initial conditions.

Anchor
TOC4
TOC4
3.1 Assigning the Initial Bottom Conditions

  1. Select the Domain/Initial Conditions & Bottom Roughness and click the Assign button (see 2381073 Figure 5).
  2. A polyline file is used to define the area to assign the bathymetry data. To assign this browse in the Poly File form to "Domain.p2d".
  3. Next browse to the bathymetry data file in the Data File form. This bathymetry file is simply a general xyz format.
  4. There are a number of options for the for user to modify the assigned. In this case, we choose in the Bathymetry Assignment Options we select Interpolated Data and Both. This will take the nearest neighbor data points to interpolate for the cells where there is no data coverage.
  5. Click the Apply button to take the effect before hitting the Done button (see 2381073see Figure 6)

Anchor
Figure 6
Figure 6


Figure 6  Assigning the bathymetry.


Anchor
TOC5
TOC5
3.2 Assigning the Depth/Water Surface Elevations

The next step is to assign the initial depth or water surface elevations. There are two options for setting the surface water elevation which are Use Constant and Use Point Measurements/Gridded Data.

  1. Click Assign button
  2. Browse in the Poly File form to "Domain.p2d"
  3. Next, browse to the water surface elevation data file "IC_WSEL.dat" in the Data File form.
  4. Checked on Use Point Measurements/Gridded Data
  5. The user click Apply button then click Done button to finish.

Anchor
Figure 7
Figure 7

Figure 7  Assigning water surface elevation.

Anchor
TOC6
TOC6
3.3 Assigning the Bottom Roughness (Z0)

  1. Click the Assign button in the Bottom Roughness (Z0) box (2381073Figure 5).
  2. Browse in the Poly File form to "Domain.p2d"
  3. Next, browse to the bottom roughness data file "IC Bot Roughness.dat" in Data folder in the Data File form.
  4. Checked on Use Point Measurements/Gridded Data
  5. Click the Apply button before hitting the Done button as shown in 2381073 Figure 8.

Anchor
Figure 8
Figure 8

Figure 8  Assigning bottom roughness.


Anchor
TOC7
TOC7
4 Assigning the Boundary Conditions

This section will guide you how to prepare for the boundary conditions and assign it to the model cell configuration. In this coastal case there are two flow boundaries; one is river discharge from the upstream and the other is tidal level. Thus, we should prepare two time series of inflow and tidal level boundaries for this particular case. In order to set a boundary time series the steps outlined below should be taken.

Anchor
TOC8
TOC8
4.1 Preparing the Flow Boundary.

  1. Select the Domain/Boundary Conditions. (See 2381073 Figure 9).
  2. Click to the E button  which is next to Flow to edit the flow boundary. (2381073Figure 9)
  3. Enter the Number of Series into the box which in this case is 1.
  4. Give a Title for associated time series, in this case "River".
  5. Click Import Data button, browse to "BC_Flow.dat" file in Data folder
  6. Select EE DAT or WQ Data format then click OK button. (See 2381073 Figure 10).
  7. Enter "-1" in Import Data form then click OK button. (See 2381073 Figure 11).
  8. Click to the Current button  to view the current time series. If there are a number of layers then check Sum Layers to show total flow. (See 2381073 Figure 12). Close timeseries data plot

  9. Click OK button in Data Series: Flow form to finish editing the boundary time series.

Anchor
Figure 9
Figure 9

Figure 9  Assigning flow boundary conditions.

Anchor
Figure 10
Figure 10

Figure 10  Editing the boundary time series (01).

Anchor
Figure 11
Figure 11

Figure 11  Editing the boundary time series (02).

   

Anchor
Figure 12
Figure 12

Figure 12  Flow time series plot.

Anchor
TOC9
TOC9
4.2 Preparing the Tidal Level Boundary.

  1. Click to the E button  which is next to Water Level (See 2381073 Figure 13)
  2. Enter the Number of Series, which is 1 for this case (see 2381073)
  3. Enter the Title of Series as "Tides"
  4. Open "BC_Water Level.dat" file in Data folder, the copy and paste into the Data Series: Water surface form.
  5. Click Current button in the form to see the timeseries plot (see 2381073). Close timeseries data plot.
  6. Click OK to finish.

Another option for setting the open boundary is the Harmonic Boundary Series (Harmonic Boundary Series)

Anchor
Figure 1213
Figure 1213

Figure 12  13  Assigning tidal boundary conditions.

Anchor
Figure 1314
Figure 1314

Figure 13  14  Preparing the tidal boundary series.

Anchor
Figure 1415
Figure 1415

Figure 14  15  Tides time series plot.

Anchor
TOC10
TOC10
4.3 Assigning Time Series to the Boundary Location Cells.

When all required boundary time series are prepared the next step is to assign those boundary time series to the model cells. Figure 14 shows the location of inflow and tidal level for the TraKhuc case.


Anchor
TOC11
TOC11
4.3.1 Assigning the Flow Boundary

In order to assign the flow boundary, the following steps should be taken

  1. Click to the ViewPlan icon  on the main form (See Figure 15).
  2. Choose Boundary C’s in the Viewing Opt’s .
  3. Check Enable Edit and Show Grid (See Figure 16).
  4. RMC on the inflow location cell/ choose New (See Figure 17).
  5. Enter the boundary group ID: River (See Figure 17).
  6. Select boundary types. It is dependent on your current boundary type to choose the suitable boundary type. In this case, we have a flow boundary so we choose number 1 (See Figure 17).
  7. Select the associated times series for this inflow boundary, "Flow" (See Figure 18).
  8. Click OK to complete.
  9. The boundary cells might have multiple cells to present the real river width. In order to assign the multiple cells, click Add by Polyline button in the form of Figure 18, you need to browse to the "US_BC Line.p2d" in the Data folder as shown in Figure 19 then click Apply button.
  10. Click All button to assign river flows to all cells ( See Figure 20)
  11. The inflow is now divided to the number of assigned cells. (See Figure 21).


Anchor
Figure 1516
Figure 1516

Figure 15  16  Locations of inflow and open tidal boundaries.

Anchor
Figure 1617
Figure 1617

Figure 16  17  Assigning boundary condition cells.

Anchor
Figure 1718
Figure 1718

Figure 17  18  Create new boundary condition with RMC on the inflow cell.

Anchor
Figure 1819
Figure 1819

Figure 18  19  Assign the corresponding time series.

Anchor
Figure 1920
Figure 1920

Figure 19  20  Assigning boundary cells by a polyline.

Anchor
Figure 2021
Figure 2021

Figure 20  21  Assigning BC to all selected cells.

Anchor
Figure 2122
Figure 2122

Figure 21  22  Upstream BC cells assigned.

...