Main Content

cdflib.setFormat

Specify format of Common Data Format (CDF) file

Syntax

cdflib.setFormat(cdfId,format)

Description

cdflib.setFormat(cdfId,format) specifies the format of a Common Data Format (CDF) file.

Input Arguments

cdfId

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

format

Format of CDF file, specified as a character vector or string scalar containing one of these format values.

'SINGLE_FILE'The CDF consists of only one file. This is the default file format
'MULTI_FILE'The CDF consists of one header file for control and attribute data and one additional file for each variable in the CDF.

You can also specify format using a numeric value. To get the numeric equivalent of the formats, use cdflib.getConstantValue.

Examples

Create a CDF file and specify its format. To run this example, you must have write permission in your current folder.

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

% Check current format
format = cdflib.getFormat(cdfId)
format =

    'SINGLE_FILE'
% Specify multifile format
cdflib.setFormat(cdfId,"MULTI_FILE")

% Check format again
format = cdflib.getFormat(cdfId)
format =

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

Tips

  • This function corresponds to the CDF library C API routine CDFsetFormat.

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