ncinfo

Return information about NetCDF data source

Syntax

finfo = ncinfo(source)
vinfo = ncinfo(source,varname)
ginfo = ncinfo(source,groupname)

Description

finfo = ncinfo(source) returns information in the structure finfo about the entire NetCDF data source specified by source, where source can be the name of a NetCDF file or the URL of an OPeNDAP NetCDF data source.

vinfo = ncinfo(source,varname) returns information in the structure vinfo about the variable varname in source.

ginfo = ncinfo(source,groupname) returns information in the structure ginfo about the group groupname in source (only NetCDF4 data sources).

    Note:   Use ncdisp for visual inspection of a NetCDF source.

Input Arguments

source

Text string specifying the name of a NetCDF file or the URL of an OPeNDAP NetCDF data source.

varname

Text string specifying the name of a variable in a NetCDF file or OPeNDAP data source.

groupname

Text string specifying the name of a group in a NetCDF file or OPeNDAP data source.

Output Arguments

finfo

A structure with the following fields.

FieldDescription 
FilenameNetCDF file name or OPeNDAP URL 
Name'/', indicating the full file 
DimensionsAn array of structures with these fields:
 NameDimension name
 LengthCurrent length of dimension
 UnlimitedBoolean flag, true for unlimited dimensions
VariablesAn array of structures with these fields:
 NameVariable name
 DimensionsAssociated dimensions
 SizeCurrent variable size
 DatatypeMATLAB® datatype
 AttributesAssociated variable attributes
 ChunkSizeChunk size, if defined. [] otherwise
 FillValueFill value of the variable.
 DeflateLevelDeflate filter level, if enabled.
 ShuffleShuffle filter enabled flag
AttributesAn array of global attributes with these fields:
 NameAttribute name
 ValueAttribute value
GroupsAn array of groups present in the file, for netcdf4 files; An empty array ([]) for all other NetCDF file formats.
FormatThe format of the NetCDF file 

vinfo

A structure containing only the variable fields from finfo.

FieldDescription
FilenameNetCDF file name
NameName of the variable
DimensionsDimensions of the variable
SizeSize of the current variable
DatatypeMATLAB datatype
AttributesAttributes associated with the variable
ChunkSizeChunk size, if defined. [] otherwise.
FillValueFill value used in the variable.
DeflateLevelDeflate filter level, if enabled.
ShuffleShuffle filter enabled flag
FormatThe format of the NetCDF file

ginfo

A structure containing only the group fields from finfo.

FieldDescription
FilenameNetCDF file name
NameName of the group
DimensionsOnly dimensions defined in the specified group
VariablesOnly variables defined in the specified group
AttributesAttributes associated with the variable
GroupsNames of groups, if defined. [] otherwise.
FormatThe format of the NetCDF file

Examples

Search for dimensions with names that start with the character x in the file.

finfo = ncinfo('example.nc');
disp(finfo);
dimNames = {finfo.Dimensions.Name};
dimMatch = strncmpi(dimNames,'x',1);
disp(finfo.Dimensions(dimMatch));

Obtain the size of a variable and check if it has any unlimited dimensions.

vinfo = ncinfo('example.nc','peaks');
varSize = vinfo.Size;
disp(vinfo);
hasUnLimDim = any([vinfo.Dimensions.Unlimited]);

Find all unlimited dimensions defined in a group.

ginfo = ncinfo('example.nc','/grid2/');
unlimDims = [ginfo.Dimensions.Unlimited];
disp(ginfo.Dimensions(unlimDims));
Was this topic helpful?