NetCDF

Network Common Data Form

Filename extension	.nc
Internet media type	application/netcdf application/x-netcdf
Magic number	CDF\001 \211HDF\r\n\032\n
Developed by	UCAR
Type of format	scientific binary data
Extended from	CDF HDF
Website	www.unidata.ucar.edu/software/netcdf/

NetCDF (Network Common Data Form) is a set of software libraries and self-describing, machine-independent data formats that support the creation, access, and sharing of array-oriented scientific data. The project homepage is hosted by the Unidata program at the University Corporation for Atmospheric Research (UCAR). They are also the chief source of netCDF software, standards development, updates, etc. The format is an open standard. NetCDF Classic and 64-bit Offset Format are an international standard of the Open Geospatial Consortium.^[1]

The project started in 1989 and is still actively supported by UCAR. Version 3.x (released in 1997) is still widely used across the world and maintained by UCAR (last update 2012). Version 4.0 (released in 2008) allows the use of the HDF5 data file format. Version 4.1 (2010) adds support for C and Fortran client access to specified subsets of remote data via OPeNDAP. Both Version 3 and Version 4 are planned to be updated by UCAR.

The format was originally based on the conceptual model of the Common Data Format developed by NASA, but has since diverged and is not compatible with it.^[2]

Format description

The netCDF libraries support 3 different binary formats for netCDF files:

• The classic format was used in the first netCDF release, and is still the default format for file creation.
• The 64-bit offset format was introduced in version 3.6.0, and it supports larger variable and file sizes.
• The netCDF-4/HDF5 format was introduced in version 4.0; it is the HDF5 data format, with some restrictions.

All formats are "self-describing". This means that there is a header which describes the layout of the rest of the file, in particular the data arrays, as well as arbitrary file metadata in the form of name/value attributes. The format is platform independent, with issues such as endianness being addressed in the software libraries. The data are stored in a fashion that allows efficient subsetting.

Starting with version 4.0, the netCDF API^[3] allows the use of the HDF5 data format. NetCDF users can create HDF5 files with benefits not available with the netCDF format, such as much larger files and multiple unlimited dimensions.

Full backward compatibility in accessing old netCDF files and using previous versions of the C and Fortran APIs is supported.

Software

Access libraries

The software libraries supplied by UCAR provide read-write access to netCDF files, encoding and decoding the necessary arrays and metadata. The core library is written in C, and provides an API for C, C++ and two APIs for Fortran applications, one for Fortran 77, and one for Fortran 90. An independent implementation, also developed and maintained by Unidata, is written in 100% Java, which extends the core data model and adds additional functionality. Interfaces to netCDF based on the C library are also available in other languages including R (ncdf,^[4] ncvar and RNetCDF^[5] packages), Perl, Python, Ruby, Haskell,^[6] Mathematica, MATLAB, IDL, and Octave. The specification of the API calls is very similar across the different languages, apart from inevitable differences of syntax. The API calls for version 2 were rather different from those in version 3, but are also supported by versions 3 and 4 for backward compatibility. Application programmers using supported languages need not normally be concerned with the file structure itself, even though it is available as open formats.

Applications

A wide range of application software has been written which makes use of netCDF files. These range from command line utilities to graphical visualization packages. A number are listed below, and a longer list^[7] is on the UCAR website.

• A commonly used set of Unix command line utilities for netCDF files is the NetCDF Operators (NCO) suite, which provide a range of commands for manipulation and analysis of netCDF files including basic record concatenating, array slicing and averaging.
• ncBrowse^[8] is a generic netCDF file viewer that includes Java graphics, animations and 3D visualizations for a wide range of netCDF file conventions.
• ncview^[9] is a visual browser for netCDF format files. This program is a simple, fast, GUI-based tool for visualising fields in a netCDF file. One can browse through the various dimensions of a data array, taking a look at the raw data values. It is also possible to change color maps, invert the data, etc.
• Panoply^[10] is a netCDF file viewer developed at the NASA Goddard Institute for Space Studies which focuses on presentation of geo-gridded data. It is written in Java and thus platform independent. Although its feature set overlaps with ncBrowse and ncview, Panoply is distinguished by offering a wide variety of map projections and ability to work with different scale color tables.
• The NCAR Command Language (NCL) is used to analyze and visualize data in netCDF files (among other formats).
• The Python programming language can access netCDF files with the PyNIO^[11] module (which also facilitates access to a variety of other data formats). netCDF files can also be read with the Python module netCDF4-python,^[12] and into a pandas-like DataFrame with the xarray module.^[13]
• Ferret is an interactive computer visualization and analysis environment designed to meet the needs of oceanographers and meteorologists analyzing large and complex gridded data sets. Ferret offers a Mathematica-like approach to analysis; new variables may be defined interactively as mathematical expressions involving data set variables. Calculations may be applied over arbitrarily shaped regions. Fully documented graphics are produced with a single command.
• The Grid Analysis and Display System (GrADS)^[14] is an interactive desktop tool that is used for easy access, manipulation, and visualization of earth science data. GrADS has been implemented worldwide on a variety of commonly used operating systems and is freely distributed over the Internet.
• nCDF_Browser^[15] is a visual nCDF browser, written in the IDL programming language. Variables, attributes, and dimensions can be immediately downloaded to the IDL command line for further processing. All the Coyote Library^[16] files necessary to run nCDF_Browser are available in the zip file.
• ArcGIS versions after 9.2^[17] support netCDF files that follow the Climate and Forecast Metadata Conventions and contain rectilinear grids with equally-spaced coordinates. The Multidimensional Tools toolbox can be used to create raster layers, feature layers, and table views from netCDF data in ArcMap, or convert feature, raster, and table data to netCDF.
• Origin 8 software imports netCDF files as matrix books where each book can hold a 4D array. Users can select a subset of the imported data to make surface, controur or image plots.
• The Geospatial Data Abstraction Library provides support^[18] for read and write access to netCDF data.
• netCDF Explorer is multi-platform graphical browser for netCDF files. netCDF Explorer can browse files locally or remotely, by means of OPeNDAP
• R supports netCDF through packages such as ncdf4 (including HDF5 support)^[19] or RNetCDF (no HDF5 support).^[20]
• HDFql enables users to manage netCDF-4/HDF5 files through a high-level language (similar to SQL) in C, C++, Java, Python and C#.

Common uses

It is commonly used in climatology, meteorology and oceanography applications (e.g., weather forecasting, climate change) and GIS applications.

It is an input/output format for many GIS applications, and for general scientific data exchange. To quote from their site:^[21]

"NetCDF (network Common Data Form) is a set of interfaces for array-oriented data access and a freely-distributed collection of data access libraries for C, Fortran, C++, Java, and other languages. The netCDF libraries support a machine-independent format for representing scientific data. Together, the interfaces, libraries, and format support the creation, access, and sharing of scientific data."

Conventions

The Climate and Forecast (CF) conventions are metadata conventions for earth science data, intended to promote the processing and sharing of files created with the NetCDF Application Programmer Interface (API). The conventions define metadata that are included in the same file as the data (thus making the file "self-describing"), that provide a definitive description of what the data in each variable represents, and of the spatial and temporal properties of the data (including information about grids, such as grid cell bounds and cell averaging methods). This enables users of data from different sources to decide which data are comparable, and allows building applications with powerful extraction, regridding, and display capabilities.

Parallel-NetCDF

An extension of netCDF for parallel computing called Parallel-NetCDF (or PnetCDF) has been developed by Argonne National Laboratory and Northwestern University.^[22] This is built upon MPI-IO, the I/O extension to MPI communications. Using the high-level netCDF data structures, the Parallel-NetCDF libraries can make use of optimizations to efficiently distribute the file read and write applications between multiple processors. The Parallel-NetCDF package can read/write only classic and 64-bit offset formats. Parallel-NetCDF cannot read or write the HDF5-based format available with netCDF-4.0. The Parallel-NetCDF package uses different, but similar APIs in Fortran and C.

Parallel I/O in the Unidata netCDF library has been supported since release 4.0, for HDF5 data files. Since version 4.1.1 the Unidata NetCDF C library supports parallel I/O to classic and 64-bit offset files using the Parallel-NetCDF library, but with the NetCDF API.

Interoperability of C/Fortran/C++ libraries with other formats

The netCDF C library, and the libraries based on it (Fortran 77 and Fortran 90, C++, and all third-party libraries) can, starting with version 4.1.1, read some data in other data formats. Data in the HDF5 format can be read, with some restrictions. Data in the HDF4 format can be read by the netCDF C library if created using the HDF4 Scientific Data (SD) API.

NetCDF-Java common data model

The NetCDF-Java library currently reads the following file formats and remote access protocols:

• BUFR Format Documentation^[23] (ongoing development)
• CINRAD level II^[24] (Chinese Radar format)
• DMSP^[25] (Defense Meteorological Satellite Program)
• DORADE^[26] radar file format
• GINI^[27] (GOES Ingest and NOAAPORT Interface) image format
• GEMPAK^[28] gridded data
• GRIB version 1 and version 2 (ongoing work on tables)
• GTOPO^[29] 30-sec elevation dataset (USGS)
• Hierarchical Data Format (HDF4, HDF-EOS2, HDF5, HDF-EOS5)
• NetCDF^[30] (classic and large format)
• NetCDF-4^[31] (built on HDF5)
• NEXRAD Radar^[32] level 2 and level 3.

There are a number of other formats in development. Since each of these is accessed transparently through the NetCDF API, the NetCDF-Java library is said to implement a Common Data Model for scientific datasets.

The Common Data Model has three layers, which build on top of each other to add successively richer semantics:

1. The data access layer, also known as the syntactic layer, handles data reading.
2. The coordinate system layer identifies the coordinates of the data arrays. Coordinates are a completely general concept for scientific data; specialized georeferencing coordinate systems, important to the Earth Science community, are specially annotated.
3. The scientific data type layer identifies specific types of data, such as grids, images, and point data, and adds specialized methods for each kind of data.

The data model of the data access layer is a generalization of the NetCDF-3 data model, and substantially the same as the NetCDF-4 data model. The coordinate system layer implements and extends the concepts in the Climate and Forecast Metadata Conventions. The scientific data type layer allows data to be manipulated in coordinate space, analogous to the Open Geospatial Consortium specifications. The identification of coordinate systems and data typing is ongoing, but users can plug in their own classes at runtime for specialized processing.

See also

• Common Data Format (CDF)
• CGNS (CFD General Notation System)
• EAS3 (Ein-Ausgabe-System)
• FITS (Flexible Image Transport System)
• GRIB (GRIdded Binary)
• Hierarchical Data Format (HDF)
• OPeNDAP client-server protocols
• Tecplot binary files
• XMDF (eXtensible Model Data Format)

References

1. "OGC standard netCDF Classic and 64-bit Offset". Opengeospatial.org. Retrieved 2013-11-27.
2. "Background - The NetCDF Users' Guide". Unidata.ucar.edu. Retrieved 2013-11-27.
3. "Version 4.0 of the netCDF API". Unidata.ucar.edu. Retrieved 2013-11-27.
4. "ncdf". Cirrus.ucsd.edu. 2013-08-06. Retrieved 2013-11-27.
5. "Rnetcdf". Cran.r-project.org. 2012-07-19. Retrieved 2013-11-27.
6. "hnetcdf: Haskell NetCDF library". hackage.haskell.org. 2014-07-10.
7. russ (1990-01-01). "List of software utilities using netCDF files". Unidata.ucar.edu. Retrieved 2013-11-27.
8. "ncBrowse". Epic.noaa.gov. Retrieved 2013-11-27.
9. "ncview". Meteora.ucsd.edu. Retrieved 2013-11-27.
10. "Panoply". Giss.nasa.gov. Goddard Institute for Space Studies. Retrieved 2013-11-27.
11. "PyNIO". Pyngl.ucar.edu. 2011-07-28. Retrieved 2013-11-27.
12. http://unidata.github.io/netcdf4-python/
13. http://xarray.pydata.org/en/stable/
14. "GrADS Home Page". Iges.org. Retrieved 2013-11-27.
15. "Coyote's Guide to IDL Programming". Dfanning.com. 2013-11-23. Retrieved 2013-11-27.
16. "Coyote Library". Dfanning.com. 2013-11-23. Retrieved 2013-11-27.
17. "ArcGIS version 9.2". Esri.com. Retrieved 2013-11-27.
18. "NetCDF network Common Data Form". Gdal.org. Retrieved 2013-11-27.
19. David Pierce (2014). ncdf4: Interface to Unidata netCDF (version 4 or earlier) format data files. R package version 1.13. https://cran.r-project.org/package=ncdf4
20. Pavel Michna and with contributions from Milton Woods (2015). RNetCDF: Interface to NetCDF Datasets. R package version 1.7-3. https://cran.r-project.org/package=RNetCDF
21. "What Is netCDF?". Unidata Program Center. Retrieved 2012-11-26.
22. "parallel-netcdf". Mcs.anl.gov. 2013-11-17. Retrieved 2013-11-27.
23. https://web.archive.org/web/20071009233507/http://dss.ucar.edu/docs/formats/bufr/. Archived from the original on October 9, 2007. Retrieved February 2, 2008. Missing or empty |title= (help)
24. Archived September 5, 2008, at the Wayback Machine.
25. Archived December 14, 2005, at the Wayback Machine.
26. Archived May 21, 2008, at the Wayback Machine.
27. "GINI Satellite Format". Weather.unisys.com. Retrieved 2013-11-27.
28. "Unidata | GEMPAK". Unidata.ucar.edu. Retrieved 2013-11-27.
29. Archived February 12, 2008, at the Wayback Machine.
30. "NetCDF". Unidata.ucar.edu. Retrieved 2013-11-27.
31. "NetCDF-4". Unidata.ucar.edu. Retrieved 2013-11-27.
32. Steve Ansari. "NCDC: Radar Resources". Ncdc.noaa.gov. Retrieved 2013-11-27.

External links

• Official website
• netCDF-Java project at UCAR
• ncBrowse - generic netCDF file viewer
• netCDF Explorer - netCDF Explorer is multi-platform graphical browser for netCDF files. netCDF Explorer can browse files locally or remotely, by means of OPeNDAP
• Unidata's Common Data Model version 4
• "An Introduction to Distributed Visualization"; section 4.2 contains a comparison of CDF, HDF, and netCDF.
• NCO, a suite of programs known as operators, which facilitate manipulation and analysis of netCDF files
• dapper data server and DChart web client for OPeNDAP in-situ data in netCDF format
• Animating NetCDF Data in ArcMap
• ncWMS, a Web Map Service and dynamic web application for visualizing NetCDF data (demo site)
• CF Conventions documents
• CF home page
• Overview of CF
• Projects and Groups using CF (partial)
• List of software utilities using netCDF files

This article is based on material taken from the Free On-line Dictionary of Computing prior to 1 November 2008 and incorporated under the "relicensing" terms of the GFDL, version 1.3 or later.