The nc_get_vars_ type family of functions read a subsampled (strided) array section of values from a netCDF variable of an open netCDF dataset. The subsampled array section is specified by giving a corner, a vector of edge lengths, and a stride vector. The values are read with the last dimension of the netCDF variable varying fastest. The netCDF dataset must be in data mode.
int nc_get_vars_text (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], char *tp); int nc_get_vars_uchar (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], unsigned char *up); int nc_get_vars_schar (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], signed char *cp); int nc_get_vars_short (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], short *sp); int nc_get_vars_int (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], int *ip); int nc_get_vars_long (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], long *lp); int nc_get_vars_float (int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], float *fp); int nc_get_vars_double(int ncid, int varid, const size_t start[], const size_t count[], const ptrdiff_t stride[], double *dp)
ncid
varid
start
count
stride
tp
up
cp
sp
ip
lp
fp
dp
nc_get_vars_ type returns the value NC_NOERR if no errors occurred. Otherwise, the returned status indicates an error. Possible causes of errors include:
Here is an example that uses nc_get_vars_double to read every other value in each dimension of the variable named rh from an existing netCDF dataset named foo.nc. For simplicity in this example, we assume that we know that rh is dimensioned with time, lat, and lon, and that there are three time values, five lat values, and ten lon values.
#include <netcdf.h> ... #define TIMES 3 #define LATS 5 #define LONS 10 int status; /* error status */ int ncid; /* netCDF ID */ int rh_id; /* variable ID */ static size_t start[] = {0, 0, 0}; /* start at first value */ static size_t count[] = {TIMES, LATS, LONS}; static ptrdiff_t stride[] = {2, 2, 2};/* every other value */ double data[TIMES][LATS][LONS]; /* array to hold values */ ... status = nc_open("foo.nc", NC_NOWRITE, &ncid); if (status != NC_NOERR) handle_error(status); ... status = nc_inq_varid (ncid, "rh", &rh_id); if (status != NC_NOERR) handle_error(status); ... /* read subsampled values from netCDF variable into array */ status = nc_get_vars_double(ncid, rh_id, start, count, stride, &data[0][0][0]); if (status != NC_NOERR) handle_error(status); ...