NETCDF_MPAS
Read MPAS NETCDF Grid Data

NETCDF_MPAS is a C 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_MPAS, a data directory which contains examples of MPAS grid data stored as NETCDF files.

Reference:

1. The MPAS home page, http://mpas-dev.github.io .
2. Russ Rew, Glenn Davis, Steve Emmerson, Harvey Davies, Ed Hartne,
   The NetCDF User's Guide,
   Unidata Program Center, March 2009,
   netcdf.pdf,
3. 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.cpp, the source code.
• netcdf_mpas.hpp, the include file.

Examples and Tests:

• netcdf_mpas_test.cpp, a sample calling program.
• netcdf_mpas_test.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"

List of Routines:

• NETCDF_MPAS_READ_CELLS gets the cell center coordinates.
• NETCDF_MPAS_READ_CELLSONEDGE gets the cellsOnEdge information.
• NETCDF_MPAS_READ_CELLSONVERTEX gets the cellsOnVertex information.
• NETCDF_MPAS_READ_MAXEDGES gets MAXEDGES.
• NETCDF_MPAS_READ_NCELLS gets the number of cells.
• NETCDF_MPAS_READ_NEDGES gets the number of edges.
• NETCDF_MPAS_READ_NEDGESONCELLS gets nedgesOnCells.
• NETCDF_MPAS_READ_NVERTICES gets the number of vertices.
• NETCDF_MPAS_READ_VERTICESONCELLS gets verticesOnCells.
• NETCDF_MPAS_READ_CELLS gets the cell center coordinates.
• NETCDF_MPAS_REPORT reads an MPAS NETCDF grid file and reports.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the C++ source codes.