Unidata - To provide the data services, tools, and cyberinfrastructure leadership that advance Earth system science, enhance educational opportunities, and broaden participation. Unidata
         
  advanced  
 
Previous: Reading a NetCDF Dataset with Known Names Next: Issues in Writing Generic NetCDF Software Table of contents Frames User guide
2008 Unidata NetCDF Workshop for Developers and Data Providers > NetCDF Example Programs

6.13 Reading a NetCDF Dataset with Unknown Names
Abstract code for reading a netCDF dataset of known structure.

It is possible to write generic software that does such things as processing every netCDF variable, without needing to know in advance the names or shapes of these variables. Similarly, the names and numbers of dimensions and attributes may be unknown.

Names and other information about netCDF objects may be obtained by calling inquire functions. These return information about a whole netCDF dataset, a dimension, a variable, or an attribute. The following template illustrates how they are used:

     nc_open                   /* open existing netCDF dataset */
       ...
     nc_inq                    /* find out what is in it */
          ...
        nc_inq_dim             /* get dimension names, lengths */
          ...
        nc_inq_var             /* get variable names, types, shapes */
             ...
           nc_inq_attname      /* get attribute names */
             ...
           nc_inq_att          /* get attribute types and lengths */
             ...
           nc_get_att          /* get attribute values */
             ...
        nc_get_var             /* get values of variables */
          ...
     nc_close                  /* close netCDF dataset */

In netCDF-3, inquire functions are inexpensive to use and require no I/O, since the information they provide is stored in memory when a netCDF dataset is first opened.

 


Previous: Reading a NetCDF Dataset with Known Names Next: Issues in Writing Generic NetCDF Software Table of contents Frames User guide
2008 Unidata NetCDF Workshop for Developers and Data Providers > NetCDF Example Programs

 
 
  Contact Us     Site Map     Search     Terms and Conditions     Privacy Policy     Participation Policy
 
National Science Foundation (NSF) UCAR Community Programs   Unidata is a member of the UCAR Community Programs, is managed by the University Corporation for Atmospheric Research, and is sponsored by the National Science Foundation.
P.O. Box 3000     Boulder, CO 80307-3000 USA     Tel: 303-497-8643     Fax: 303-497-8690