NETCDF_MPAS
Read MPAS NETCDF Grid Data

NETCDF_MPAS is a MATLAB library which reads an MPAS NETCDF grid file.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

NETCDF_MPAS is available in a C++ version and a MATLAB version.

Related Programs:

CDL, a data directory which contains examples of CDL files, a text version of NETCDF files created by the NCDUMP program;

GFD2, a dataset directory which contains geophysical data, stored in NETCDF format.

MPAS_GRID_DISPLAY, MATLAB programs which can read an MPAS NETCDF grid file and display the primary polygonal mesh or the dual triangular mesh.

NETCDF, a data directory which contains examples of NETCDF files, a format for the interchange of scientific data.

NETCDF_GIS_READ, MATLAB programs which read GIS data stored as a NETCDF file.

NETCDF_GLIMMER, MATLAB programs which read and write GLIMMER grid and solution data stored as a NETCDF file.

NETCDF_MPAS, a data directory which contains examples of MPAS grid data stored as NETCDF files.

Reference:

1. Russ Rew, Glenn Davis, Steve Emmerson, Harvey Davies, Ed Hartne,
   The NetCDF User's Guide,
   Unidata Program Center, March 2009.
2. Todd Ringler, John Thuburn, Joseph Klemp, William Skamarock,
   A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids,
   Journal of Computational Physics,
   Volume 229, Number 9, 1 May 2010, pages 3065-3090.

Source Code:

• netcdf_mpas_read_cellsonedge.m, reads the cell locations, and the pairs of cells that define the edges of the triangulation.
• netcdf_mpas_read_cellsonvertex.m, reads the cell locations, and the triples of cells that define the triangles of the triangulation.
• netcdf_mpas_read_xyzcell.m, reads the cell locations.
• netcdf_mpas_report.m, reads a NETCDF MPAS grid file and reports its contents.
• timestamp.m, prints the YMDHMS date as a timestamp.

Examples and Tests:

NETCDF_MPAS_TEST calls the tests.

• netcdf_mpas_test.m, calls the tests.
• netcdf_mpas_test01.m, reads the file and prints some information;
• netcdf_mpas_test02.m, extracts information about the number and location of cells.
• cells.png, a PNG image of the cells.
• netcdf_mpas_test03.m, extracts information about the cell locations and the pairs of cells that define each line of the triangulation, allowing us to draw the lines of the triangulation.
• triangulation_lines.png, a PNG image of the lines of the triangulation.
• netcdf_mpas_test04.m, extracts information about the cell locations and the three cells that form each triangle, allowing us to draw the faces of the triangulation.
• triangulation_faces.png, a PNG image of the faces of the triangulation.
• netcdf_mpas_test_output.txt, the output file.

X1.642.GRID is a dataset of 642 cells used by the example.

• x1.642.grid.nc, an MPAS grid file for a mesh on the sphere, using 642 nodes, 1280 vertices, 1920 edges.
• x1.642.grid.header, a text printout of the header information in the file, created by the command "ncdump -h x1.642.grid.nc > x1.642.grid.header"

You can go up one level to the MATLAB source codes.