This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Create NetCDF variable


varid = netcdf.defVar(ncid,varname,xtype,dimids)


varid = netcdf.defVar(ncid,varname,xtype,dimids) creates a new variable in the dataset identified by ncid.

varname is a character vector that specifies the name of the variable.

xtype specifies the NetCDF data type of the variable, using one of these values.

Value of xtypeMATLAB® Class
'NC_BYTE'int8 or uint8[a]


NetCDF interprets byte data as either signed or unsigned.

Alternatively, xtype can be the numeric equivalent returned by the netcdf.getConstant function.

dimids specifies a list of dimension IDs.

netcdf.defVar returns varid, a numeric identifier for the new variable.

This function corresponds to the nc_def_var function in the NetCDF library C API. Because MATLAB uses FORTRAN-style ordering, the fastest-varying dimension comes first and the slowest comes last. Any unlimited dimension is therefore last in the list of dimension IDs. This ordering is the reverse of that found in the C API.To use this function, you should be familiar with the NetCDF programming paradigm. See netcdf for more information.


collapse all

Create a new NetCDF file, define a dimension in the file, and then define a variable on that dimension. In NetCDF files, you must create a dimension before you can create a variable. To run this example, you must have write permission in your current folder.

Create a new NetCDF file named

ncid = netcdf.create('','NC_NOCLOBBER');

Define a dimension in the new file.

dimid = netcdf.defDim(ncid,'x',50);

Define a variable in the new file using netcdf.defVar.

varid = netcdf.defVar(ncid,'myvar','NC_DOUBLE',dimid)
varid = 0

netcdf.defVar returns a numeric identifier for the new variable.

Close the file.

Was this topic helpful?