exponenta event banner

ncwrite

Запись данных в файл NetCDF

Описание

пример

ncwrite(filename,varname,vardata) записывает текстовые или числовые данные в vardata к существующей переменной varname в файле NetCDF filename.

ncwrite функция записывает данные в vardata начиная с начала переменной и, при необходимости, автоматически расширяет неограниченные размеры. Дополнительные сведения о неограниченных размерах см. в разделе Dimensions аргумент nccreate функция.

пример

ncwrite(filename,varname,vardata,start) записывает данные в существующую переменную, начиная с местоположения, указанного в start. Этот синтаксис используется для добавления данных к существующей переменной или для записи частичных данных.

пример

ncwrite(filename,varname,vardata,start,stride) записывает данные с интервалом между индексами каждого измерения, указанным stride.

Примеры

свернуть все

Создайте файл NetCDF, содержащий переменную, а затем запишите данные в эту переменную.

Создать новый файл myfile.nc содержащий переменную с именем pi.

nccreate('myfile.nc','pi');

Запись скалярных данных без размеров в переменную pi.

ncwrite('myfile.nc','pi',3.1416);

Считывание и отображение переменной из файла.

valPi = ncread('myfile.nc','pi')
valPi = 3.1416

Запись данных в часть переменной в файле NetCDF, начиная с указанного местоположения.

Создание файла myncfile.nc с пустым 3около-6 числовая переменная vmark. Чтобы отключить значение заполнения по умолчанию для отсутствующих или пустых переменных, задайте значение FillValue аргумент пары имя-значение для disable.

nccreate('myncfile.nc','vmark',...
         'Dimensions', {'x',3,'y',6},...
         'FillValue','disable');     

Написать 3около-3 массив к переменной, а затем чтение и отображение vmark из файла. ncwrite функция записывает данные, начиная с начала переменной.

ncwrite('myncfile.nc','vmark',3*eye(3));
varData = ncread('myncfile.nc','vmark');
display(varData)
varData = 3×6

     3     0     0     0     0     0
     0     3     0     0     0     0
     0     0     3     0     0     0

Добавить еще 3около-3 массив к переменной vmark начиная с четвертого столбца первой строки. Далее, чтение и отображение vmark из файла. ncwrite функция записывает массив, начиная с местоположения [1 4].

ncwrite('myncfile.nc','vmark',5*eye(3),[1 4]);
varData = ncread('myncfile.nc','vmark');
display(varData)
varData = 3×6

     3     0     0     5     0     0
     0     3     0     0     5     0
     0     0     3     0     0     5

Запись данных с заданным интервалом между переменными индексами вдоль каждого измерения.

Сначала создайте файл myncfile.nc с пустым 6около-6 числовая переменная vmark. Чтобы отключить значение заполнения по умолчанию для отсутствующих или пустых переменных, задайте значение FillValue аргумент пары имя-значение для disable.

nccreate('myncfile.nc','vmark',...
         'Dimensions', {'x',6,'y',6},...
         'FillValue','disable'); 

Далее напишите 3около-3 числовой массив к переменной vmark начиная с местоположения [1 1] с интервалом в 2 между индексами переменных вдоль каждого измерения. Чтение и отображение vmark из файла.

ncwrite('myncfile.nc','vmark',3*eye(3),[1 1],[2 2]);
varData = ncread('myncfile.nc','vmark');
display(varData)
varData = 6×6

     3     0     0     0     0     0
     0     0     0     0     0     0
     0     0     3     0     0     0
     0     0     0     0     0     0
     0     0     0     0     3     0
     0     0     0     0     0     0

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

свернуть все

Имя существующего файла NetCDF, указанное как вектор символов или скаляр строки.

Если файл или переменная NetCDF не существуют, используйте nccreate чтобы создать их первыми.

Типы данных: char | string

Имя переменной, определяемое как вектор символов или строка, содержащая имя переменной в файле NetCDF.

Типы данных: char | string

Переменные данные, указанные как числовые данные или текст.

Примечание

Для переменных значений, содержащих текстовые данные, vardata входные данные должны содержать только символы в кодировке ASCII.

Если переменная varname существует, затем ncwrite ожидает тип данных vardata для соответствия типу данных переменной NetCDF.

Если переменная varname имеет атрибуты _FillValue, scale_factor, или add_offset, то ncwrite функция ожидает, что данные будут иметь тип данных double. Бросать vardata в тип данных NetCDF, ncwrite функция применяет следующие соглашения по атрибутам в последовательности:

  1. Вычитание значения add_offset атрибут из vardata.

  2. Разделиться vardata по значению scale_factor атрибут.

  3. Заменить любое NaN в vardata со значением, содержащимся в _FillValue атрибут. Если этот атрибут не существует, то ncwrite использует значение заливки для этой переменной, указанное в библиотеке NetCDF.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char

Начальное расположение данных в переменной, определяемое как вектор индексов. Для N-мерная переменная, start - вектор длины N, содержащий индексы на основе 1.

Если не указать start, то ncwrite функция начинает запись переменной из первого индекса по каждому измерению.

Типы данных: double

Пространство между индексами переменных вдоль каждого измерения, определяемое как числовой вектор целых чисел. Для N-мерная переменная, stride - вектор длины N. Элементы stride вектор соответствует по порядку размерам переменной. Значение 1 записывает смежные значения переменной NetCDF в соответствующее измерение. Где as, значение 2 записывает все другие значения переменной NetCDF в соответствующее измерение и т.д.

Если не указать stride, то ncwrite функция записывает данные с интервалом по умолчанию, равным 1 вдоль каждого размера.

Типы данных: double

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