ncwrite

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

Описание

пример

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

The 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-by- 6 числовая переменная vmark. Чтобы отключить значение заливки по умолчанию для отсутствующих или пустых переменных, установите значение FillValue аргумент пары "имя-значение" в disable.

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

Написание 3-by- 3 массив к переменной, а затем чтение и отображение vmark из файла. The 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-by- 3 массив к переменной vmark начиная с четвертого столбца первой строки. Далее читайте и отображайте vmark из файла. The 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-by- 6 числовая переменная vmark. Чтобы отключить значение заливки по умолчанию для отсутствующих или пустых переменных, установите значение FillValue аргумент пары "имя-значение" в disable.

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

Далее напишите 3-by- 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 в соответствующую размерность. Где как, значение 2 записывает каждое другое значение переменной NetCDF в соответствующей размерности и так далее.

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

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

Введенный в R2011a