NetCDF Files

Network Common Data Form

Read or write netCDF files using MATLAB^® high-level functions or the netCDF library package of low-level functions. High-level functions simplify the process of reading data from a netCDF file or writing a variable from the MATLAB workspace into a netCDF file.

For more control over the reading and writing process, use the NetCDF Library Package containing low-level functions. The low-level functions enable more control over the reading and writing process by providing access to the routines in the NetCDF C library.

MATLAB supports netCDF version 4.8.1.

Functions

expand all

Read or Write NetCDF Files

`nccreate`	Create variable in netCDF file
`ncdisp`	Display contents of netCDF data source in Command Window
`ncinfo`	Return information about netCDF data source
`ncread`	Read data from variable in netCDF data source
`ncreadatt`	Read attribute value from netCDF data source
`ncwrite`	Write data to netCDF file
`ncwriteatt`	Write attribute to netCDF file
`ncwriteschema`	Add netCDF schema definitions to netCDF file

NetCDF Library Package

Library Functions

`netcdf.getChunkCache`	Retrieve chunk cache settings for NetCDF library
`netcdf.inqLibVers`	Return NetCDF library version information
`netcdf.setChunkCache`	Set default chunk cache settings for NetCDF library
`netcdf.setDefaultFormat`	Change default netCDF file format

File Operations

`netcdf.abort`	Revert recent netCDF file definitions
`netcdf.close`	Close netCDF file
`netcdf.create`	Create new netCDF dataset
`netcdf.endDef`	End netCDF file define mode
`netcdf.inq`	Return information about netCDF file
`netcdf.inqFormat`	Determine format of NetCDF file
`netcdf.inqGrps`	Retrieve array of child group IDs
`netcdf.inqUnlimDims`	Return list of unlimited dimensions in group
`netcdf.open`	Open NetCDF data source
`netcdf.reDef`	Put open netCDF file into define mode
`netcdf.setFill`	Set netCDF fill mode
`netcdf.sync`	Synchronize netCDF file to disk

Dimensions

`netcdf.defDim`	Create netCDF dimension
`netcdf.inqDim`	Return netCDF dimension name and length
`netcdf.inqDimID`	Return dimension ID
`netcdf.renameDim`	Change name of netCDF dimension

Groups

`netcdf.defGrp`	Create group in NetCDF file
`netcdf.inqDimIDs`	Retrieve list of dimension identifiers in group
`netcdf.inqGrpName`	Retrieve name of group
`netcdf.inqGrpNameFull`	Complete pathname of group
`netcdf.inqGrpParent`	Retrieve ID of parent group
`netcdf.inqNcid`	Return ID of named group
`netcdf.inqVarIDs`	IDs of all variables in group

Variables

`netcdf.defVarFill`	Define fill parameters for NetCDF variable
`netcdf.defVar`	Create netCDF variable
`netcdf.defVarChunking`	Define chunking behavior for NetCDF variable
`netcdf.defVarDeflate`	Define compression parameters for NetCDF variable
`netcdf.defVarFletcher32`	Define checksum parameters for NetCDF variable
`netcdf.getVar`	Read data from netCDF variable
`netcdf.inqVar`	Information about variable
`netcdf.inqVarChunking`	Determine chunking settings for NetCDF variable
`netcdf.inqVarDeflate`	Determine compression settings for NetCDF variable
`netcdf.inqVarFill`	Determine values of fill parameters for NetCDF variable
`netcdf.inqVarFletcher32`	Fletcher32 checksum setting for NetCDF variable
`netcdf.inqVarID`	Return ID associated with variable name
`netcdf.putVar`	Write data to netCDF variable
`netcdf.renameVar`	Change name of netCDF variable

Attributes

`netcdf.copyAtt`	Copy attribute to new location
`netcdf.delAtt`	Delete netCDF attribute
`netcdf.getAtt`	Return NetCDF attribute
`netcdf.inqAtt`	Return information about netCDF attribute
`netcdf.inqAttID`	Return ID of netCDF attribute
`netcdf.inqAttName`	Return name of netCDF attribute
`netcdf.putAtt`	Write NetCDF attribute
`netcdf.renameAtt`	Change name of attribute

User-Defined Types

`netcdf.defVlen`	Define user-defined variable length array type (NC_VLEN)
`netcdf.inqUserType`	Return information about user-defined type
`netcdf.inqVlen`	Return information about user-defined `NC_VLEN` type

Utilities

`netcdf.getConstant`	Return numeric value of named constant
`netcdf.getConstantNames`	Return list of constants known to netCDF library

Topics

Import NetCDF Files and OPeNDAP Data
Read data from a NetCDF file using the high-level functions, and then read the file by using the netcdf package low-level functions.
Export to NetCDF Files
Create, merge, and write NetCDF files using high-level functions and the netcdf package low-level functions.
Map NetCDF API Syntax to MATLAB Syntax
The MATLAB netcdf package of low-level functions map to the corresponding routines and data types in the NetCDF C library.

Troubleshooting

Resolve Errors Reading OPeNDAP Data

When you have trouble reading OPeNDAP data, consider these factors.

Related Information

netCDF website