exponenta event banner

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 для получения схемы переменной пиков из файла. Затем использовать ncwriteschema для создания файла NetCDF, определяющего переменную пиков. Использовать ncread получить данные, связанные с переменной пиков, а затем использовать 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