ncinfo

Возврат информации об источнике данных NetCDF

Синтаксис

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

Описание

finfo = ncinfo(source) возвращает информацию в структуре finfo обо всем источнике данных NetCDF, указанном source, где источником может быть имя файла NetCDF или URL источника данных OPeNDAP NetCDF.

vinfo = ncinfo(source,varname) возвращает информацию в структуре vinfo о переменной varname в source.

ginfo = ncinfo(source,groupname) возвращает информацию в структуре ginfo о группе groupname в source (только NetCDF4 источники данных).

Примечание

Использовать ncdisp для визуальной проверки источника NetCDF.

Входные аргументы

`source`	Вектор символов или строковый скаляр, указывающий имя файла NetCDF или URL-адрес источника данных OPeNDAP NetCDF.
`varname`	Вектор символов или строковый скаляр, указывающий имя переменной в файле NetCDF или источнике данных OPeNDAP.
`groupname`	Вектор символов или строковый скаляр, указывающий имя группы в файле NetCDF или источнике данных OPeNDAP.

Выходные аргументы

finfo

Структура со следующими полями.

Область	Описание
`Filename`	Имя файла NetCDF или URL-адрес OPeNDAP
`Name`	`'/'`, с указанием полного файла
`Dimensions`	Массив структур со следующими полями:
	`Name`	Имя измерения
	`Length`	Текущая длина размера
	`Unlimited`	Логический флаг, true для неограниченных размеров
`Variables`	Массив структур со следующими полями:
	`Name`	Имя переменной
	`Dimensions`	Связанные размеры
	`Size`	Текущий размер переменной
	`Datatype`	Тип данных MATLAB ®
	`Attributes`	Связанные атрибуты переменных
	`ChunkSize`	Размер блока, если он определен. `[]` иначе
	`FillValue`	Значение заливки переменной.
	`DeflateLevel`	Дефлировать уровень фильтра, если он включен.
	`Shuffle`	Флаг включения фильтра тасования
`Attributes`	Массив глобальных атрибутов со следующими полями:
	`Name`	Наименование атрибута
	`Value`	Значение атрибута
`Groups`	Массив групп, присутствующих в файле, для `netcdf4` файлы; Пустой массив (`[]`) для всех других форматов файлов NetCDF.
`Format`	Формат файла NetCDF

vinfo

Структура, содержащая только поля переменных из finfo.

Область	Описание
`Filename`	Имя файла NetCDF
`Name`	Имя переменной
`Dimensions`	Размеры переменной
`Size`	Размер текущей переменной
`Datatype`	Тип данных MATLAB
`Attributes`	Атрибуты, связанные с переменной
`ChunkSize`	Размер блока, если он определен. `[]` в противном случае.
`FillValue`	Значение заливки, используемое в переменной.
`DeflateLevel`	Дефлировать уровень фильтра, если он включен.
`Shuffle`	Флаг включения фильтра тасования
`Format`	Формат файла NetCDF

ginfo

Структура, содержащая только поля группы из finfo.

Область	Описание
`Filename`	Имя файла NetCDF
`Name`	Имя группы
`Dimensions`	Только размеры, определенные в указанной группе
`Variables`	Только переменные, определенные в указанной группе
`Attributes`	Атрибуты, связанные с переменной
`Groups`	Имена групп, если они определены. `[]` в противном случае.
`Format`	Формат файла NetCDF

Примеры

Поиск размеров с именами, начинающимися с символа x в файле.

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

Получение размера переменной и проверка наличия неограниченных размеров.

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

Найти все неограниченные размеры, определенные в группе.

ginfo = ncinfo('example.nc','/grid2/');
unlimDims = [ginfo.Dimensions.Unlimited];
disp(ginfo.Dimensions(unlimDims));

См. также

ncdisp | ncread | ncwrite | ncwriteschema

Темы

Импорт файлов NetCDF и данных OPeNDAP

Представлен в R2011a

Документация