6.5 Learn About Chunking Parameters for a Variable: NF_INQ_VAR_CHUNKING
The function NF_INQ_VAR_CHUNKING returns the chunking settings for a
variable in a netCDF-4 file.
Usage
NF_INQ_VAR_CHUNKING(INTEGER NCID, INTEGER VARID, INTEGER CONTIGUOUS, INTEGER CHUNKSIZES);
NCID- NetCDF ID, from a previous call to NF_OPEN or NF_CREATE.
VARID- Variable ID.
VARID- Set to 1 if this variable uses contiguous storage, 0 if it used
chunked storage.
CHUNKSIZES- An array of chunk sizes. The length of CHUNKSIZES must be the same as
the number of dimensions of the variable.
Errors
NF_INQ_VAR_CHUNKING returns the value NF_NOERR if no errors
occurred. Otherwise, the returned status indicates an error.
Possible return codes include:
NF_NOERR- No error.
NF_BADID- Bad ncid.
NF_ENOTNC4- Not a netCDF-4 file.
NF_ENOTVAR- Can't find this variable.
Example
In this example from nf_test/ftst_vars.F, a variable with chunked
storage is check to ensure that the chunksizes are set to expected
values.
C Is everything set that is supposed to be?
retval = nf_inq_var_chunking(ncid, varid, contiguous, chunks_in)
if (retval .ne. nf_noerr) call handle_err(retval)
if (contiguous .ne. 0) stop 2
if (chunks(1) .ne. chunks_in(1)) stop 2
if (chunks(2) .ne. chunks_in(2)) stop 2
