Versions Compared

Key

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

According to the Unidata website the Network Common Data Form (NetCDF) software was originally intended to create, access, and share array-oriented data in a form that is self-describing and portable. These deal with a variety of data types that encompass single-point observations, time series, regularly-spaced grids, and satellite or radar images.

...

There is now an unstructured (or flexible mesh) model data format for NetCDF called UGRID.  From the EEMS10.4 version, DSI enhanced the NetCDF capabilities of the the EFDC_+ Explorer Modeling System (EEMS), so that it is able to handle the UGRID format. Although UGRID is designed for unstructured grids, the advantage for EFDC+ and structured grids is that it writes output for only the active grid cells, rather than the full I,J grid required by web map services for displaying environmental data such as ncWMS. Furthermore, the structure of the output variables is clearly defined, along with the variable name and units. This allows users to easily process EFDC+ output using third-party software.  UGRID is also based on the CF Metadata Conventions, but this approach currently assumes that the horizontal topology should be determined from the cell index of the EFDC+ grid rather than the I,J indices of the structured grid. The UGRID approach adds conventions to specify the topology for unstructured (e.g., triangular) grids.

...

EFDC+ can currently write the native output in NetCDF-CF format for Windows and Linux. EFDC_+ Explorer (the pre-and post-processor for EFDC+) can also convert the binary files output by EFDC+ (*.OUT) to netCDF.nc files, including the derived water quality parameters. EFDC+ currently exports 44 parameters to NetCDF format. This allows EFDC+ output to be read and displayed on web servers. It should be noted that while the display order of some dimensions (i.e. TIME, KC, CELL) in *.nc output files exported from EFDC+ Explorer may differ from that obtained directly from EFDC+, the values of variables are not impacted and retrieved correctly with reference to their descriptive data.

EFDC+ exports the NetCDF files at the same interval that it produces the model linkages files, which is set in the tab for Timing and Linkage | Linkage | NetCDF

The main configuration for NetCDF output is in the EFDC_Exlporer Linkage | NetCDF tabs as shown in 240419309 Figure 1.  Here the user can turn on netCDF output by checking the Output to NetCDF checkbox.  The user may select the level at which the NetCDF data is compressed with the Deflate Level setting. This can range from 1, no compression, to 9 for maximum compression, but is recommended by Unidata to be set to 2 for the best balance between file size and speed. 

...

Info
titleNote
  • After running the model, the user must close the EFDC+ run window using the carriage return before viewing the netCDF output. Using the X button on the run window will mean NetCDF output will not be written. 
  • The calendar date is the default date in the NetCDF output.
  • Layer ordering in the water column and sediment bed will be reversed in NetCDF compared to that of EE. 
  • Units in NetCDF are often different from those in EE, for example, bed toxics in NetCDF are in mg/m2 rather than mg/kg as they are in EE.
  • When extracting results from NetCDF file, users should take care regarding the L cell index. The loop of the cell list in EFDC+ starts from L = 2 (i.e. corresponding to the first active cell), while with tools used to extract data from NetCDF, such as Python or Matlab, start the loop from 0 or 1, respectively.

Displaying NetCDF Output

There are a number of options available to the user for displaying netCDF output, such as using ArcGIS, or using web-based tools such as ncWMS. Some of these are outlined here to help the user to become familiar with these tools.

...

ncWMS loads native netCDF files and displays them on a web browser. To make Making the output the same as EE10 would require further adjustment to the tool. For the purposes of this demonstration, the basic display of the output is shown in the next section.

...

Python script can be used to read the netCDF output of the model. For example, a model with 1000 horizontal grids, and 5 layers, and the model simulated with 1-hour output frequency for 10 days. So each day will have 25-time steps → there are 1000*5*(24*10 + 1) = 1,205,000 lines totally. In which of the total lines there are lines with NaN values (dry cells), they should be removed. The User can contact us to get the script.

...

To demonstrate the netCDF output is consistent with the data viewed in EE, a number of comparisons have been made for different models. Examples of an output from the West Lake WQ model in EE, ArcGIS, and ncWMS are shown in 240419309 Figure 3, Figure 4 and Figure 5 respectively.  Note that the West Lake model may be downloaded from the EE website.

...