ncmeta-package: ncmeta: Straightforward 'NetCDF' Metadata

ncmeta-packageR Documentation

ncmeta: Straightforward 'NetCDF' Metadata

Description

Extract metadata from 'NetCDF' data sources, these can be files, file handles or servers. This package leverages and extends the lower level functions of the 'RNetCDF' package providing a consistent set of functions that all return data frames. We introduce named concepts of 'grid', 'axis' and 'source' which are all meaningful entities without formal definition in the 'NetCDF' library https://www.unidata.ucar.edu/software/netcdf/. 'RNetCDF' matches the library itself with only the named concepts of 'variables', 'dimensions' and 'attributes'.

ncmeta provides a consistent set of tools to obtain metadata from NetCDF. NetCDF is 'Network Common Data Form' https://www.unidata.ucar.edu/software/netcdf/. These functions are generics, allowing methods to be written for various providers so that everything can work from a common basis. All functions return a data frame.

Details

Each function responds to a character file name or data source (i.e. URL) or to a connection of a given class, this is so a source connection may be created a minimal number of times and kept open while a number of entities are queried.

Each "given" entity may be referred to by index (0-based) or name, just as it would be by the NetCDF API and by the two R wrapper providers RNetCDF and ncdf4.

nc_att find the given attribute of a given variable
nc_atts find all attributes, of all variables and globals
nc_axes find all the instances of dimensions
nc_axis find given instance of a dimension (1-based)
nc_dim find the given dimension of a source (0-based)
nc_dims find all the dimensions of a source
nc_grids find the grids (sets of dimensions) of a source
nc_inq inquire about a source (i.e. number of dimensions, number of variables, number of global attributes and presence of unlimited dimension
nc_meta find all metadata for a source (runs all other functions)
nc_sources tags a record of a source and its "access time"
nc_var find a given variable (0-based)
nc_vars find the variables of a source

Author(s)

Maintainer: Michael Sumner mdsumner@gmail.com

Other contributors:

  • Tomas Remenyi [contributor]

  • Ben Raymond [contributor]

  • David Blodgett [contributor]

  • Milton Woods [contributor]

See Also

Useful links:


ncmeta documentation built on Nov. 2, 2023, 5:57 p.m.