ncwriteschema

Добавьте определения схем NetCDF к файлу NetCDF

Синтаксис

ncwriteschema(filename,schema)

Описание

ncwriteschema(filename,schema) создает или добавляет атрибуты, размерности, определения переменных и структуру группы, определенные в schema в файл filename.

Использование ncwriteschema в сочетании с ncinfo для создания нового файла NetCDF на основе схемы существующего файла. Можно также использовать ncwriteschema для добавления определений переменных, атрибутов, размерностей или структуры группы к существующему файлу.

Примечание

ncwriteschema не записывает переменные данные. Использование ncwrite для записи данных в созданные переменные. Созданные неограниченные размерности будут иметь начальный размер 0, пока вы не запишете данные.

Примечание

ncwriteschema невозможно изменить формат существующего файла. Он не может переопределить существующие переменные и размерности в filename. Если ваша схема содержит атрибуты, размерности, определения переменных или структуру группы, которая уже существует в файле, writeschema выдает предупреждение, но продолжает обработку.

Входные параметры

filename

Вектор символов или строковый скаляр, содержащий имя файла NetCDF. Если filename не существует, ncwriteschema создает новый файл с помощью netcdf4_classic формат, если только не Format поле в schema задает другой формат.

schema

Структура или массив структур, представляющих либо размерность, либо переменную, либо целый файл NetCDF или netcdf4 группа. Группа или схема файла могут содержать размерность или схему переменных, или то и другое. Можно использовать выходы, возвращенные ncinfo как schema структура. В следующей таблице перечислены поля в различных типах структур схемы. Необязательные поля отмечены звездочкой (*).

Тип схемыСтруктурное полеОписание
Групповая/файловая схемаNameВектор символов или строковый скаляр, идентифицирующий имя группы. Использование '/' для указания всего файла.
 Dimensions*Размерность
 Variables*Схема переменной
 Attributes*Структурируйте массив групповых/глобальных атрибутов с полями Имя и Значение
 Format*Вектор символов или строковый скаляр, идентифицирующий формат файла NetCDF
РазмерностьNameВектор символов или строковый скаляр, идентифицирующий размерность
 LengthДлина размерности. Можно Inf.
 Unlimited*Логический флаг, указывающий, является ли размерность неограниченным
 Format*Вектор символов или строковый скаляр, идентифицирующий формат файла NetCDF
Схема переменнойNameВектор символов или строковый скаляр, идентифицирующий имя переменной
 DimensionsСхема размерности переменной
 DatatypeВектор символов или строковый скаляр, идентифицирующий MATLAB® тип данных
 Attributes*Структурируйте массив атрибутов переменной с полями Имя и Значение
 ChunkSize*Числовое значение, определяющее размер фрагмента переменной
 FillValue*Текстовое или числовое значение заливки
 DeflateValue*Дефляция уровня сжатия
 Shuffle* Логический флаг для включения фильтра Shuffle
 Format*Вектор символов или строковый скаляр, идентифицирующий формат файла NetCDF

Примеры

Создайте классический файл формата с двумя определениями размерностей.

mySchema.Name   = '/';
mySchema.Format = 'classic';
mySchema.Dimensions(1).Name   = 'time';
mySchema.Dimensions(1).Length = Inf;
mySchema.Dimensions(2).Name   = 'rows';
mySchema.Dimensions(2).Length = 10;
ncwriteschema('emptyFile.nc', mySchema);
ncdisp('emptyFile.nc');

Создайте netcdf4_classic формат файла для хранения одной переменной из существующего файла. Первое использование ncinfo для получения схемы переменной peaks из файла. Затем используйте ncwriteschema чтобы создать файл NetCDF, определяющий переменную peaks. Использование ncread получить данные, сопоставленные с переменной peaks, и затем использовать ncwrite чтобы записать данные в переменную в новом файле NetCDF.

myVarSchema = ncinfo('example.nc','peaks');
ncwriteschema('peaksFile.nc',myVarSchema);
peaksData   = ncread('example.nc','peaks');
ncwrite('peaksFile.nc','peaks',peaksData);
ncdisp('peaksFile.nc');
Введенный в R2011a