Main Content

cdflib.setVarSparseRecords

Specify how variable handles sparse records

Syntax

cdflib.getVarSparseRecords(cdfId,varNum,stype)

Description

cdflib.getVarSparseRecords(cdfId,varNum,stype) specifies the sparse records type of a variable in a Common Data Format (CDF) file.

Input Arguments

cdfId

Identifier of a CDF file, returned by a call to cdflib.create or cdflib.open.

varNum

Number that identifies the variable to be set. Variable numbers are zero-based.

stype

One of the following character vectors or string scalars that specifies how the variable handles sparse records, or its numeric equivalent.

Value Description
'NO_SPARSERECORDS'No sparse records
'PAD_SPARSERECORDS'For sparse records, the library uses the variable's pad value when reading values from a missing record.
'PREV_SPARSERECORDS'For sparse records, the library uses values from the previous existing record when reading values from a missing record. If there is no previous existing record, the library uses the variable's pad value.

To get the numeric equivalent of these values, use the cdflib.getConstantValue function.

Examples

Open a multifile CDF and close a variable.

Create a CDF, create a variable, and set the sparse records type of the variable. To run this example you must be in a writable folder.

cdfId = cdflib.create("your_file.cdf");

% Create a variable in the file
varNum = cdflib.createVar(cdfId,"Time","cdf_int1",1,[],true,[]);

% Check the sparse records type of the variable
stype = cdflib.getVarSparseRecords(cdfId,varNum)
stype =

    'NO_SPARSERECORDS'
% Set the sparse records type of the variable
cdflib.setVarSparseRecords(cdfId,varNum,"PAD_SPARSERECORDS")

% Check the new sparse records type of the variable
stype = cdflib.getVarSparseRecords(cdfId,varNum)
stype =

    'PAD_SPARSERECORDS'
%Clean up
cdflib.delete(cdfId)
clear cdfId

References

This function corresponds to the CDF library C API routine CDFsetzVarSparseRecords.

To use this function, you must be familiar with the CDF C interface. You can access the CDF documentation at the CDF website.