nccreate

Создайте переменную в файле NetCDF

Синтаксис

nccreate(filename,varname)
nccreate(filename,varname,Name,Value)

Описание

пример

nccreate(filename,varname) создает скалярную переменную double под названием varname в файле NetCDF, заданном filename. Если filename не существует, то nccreate создает файл с помощью формата netcdf4_classic.

пример

nccreate(filename,varname,Name,Value) создает переменную с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Например, чтобы создать нескалярную переменную, используйте аргумент пары "имя-значение" Dimensions.

Примеры

свернуть все

Создайте файл с именем NetCDF myexample.nc, который содержит переменную под названием Var1.

nccreate('myexample.nc','Var1')

Создайте вторую переменную в том же файле.

nccreate('myexample.nc','Var2')

Отобразите содержимое файла NetCDF.

ncdisp('myexample.nc')
Source:
           pwd\myexample.nc
Format:
           netcdf4_classic
Variables:
    Var1
           Size:       1x1
           Dimensions: 
           Datatype:   double
    Var2
           Size:       1x1
           Dimensions: 
           Datatype:   double

Создайте новую двумерную переменную под названием peaks в классике (NetCDF 3) файл формата под названием myncclassic.nc. Используйте аргумент пары "имя-значение" 'Dimensions', чтобы задать имена и длины этих двух размерностей. Используйте аргумент пары "имя-значение" 'Format', чтобы задать формат файла.

nccreate('myncclassic.nc','peaks',...
          'Dimensions',{'r',200,'c',200},...
          'Format','classic')

Запишите данные к переменной.

ncwrite('myncclassic.nc','peaks',peaks(200))

Отобразите содержимое файла NetCDF.

ncdisp('myncclassic.nc')
Source:
           pwd\myncclassic.nc
Format:
           classic
Dimensions:
           r = 200
           c = 200
Variables:
    peaks
           Size:       200x200
           Dimensions: r,c
           Datatype:   double

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

свернуть все

Имя файла, заданное как вектор символов или скаляр строки. Файл является существующим файлом NetCDF или именем, которое вы хотите присвоить новому файлу NetCDF.

Пример: 'myFile.nc'

Имя новой переменной, заданной как символьный вектор или скаляр строки.

Пример: 'myVar'

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: nccreate('myFile.nc','Var1','Datatype','double','Format','classic') создает переменную под названием Var1 типа NC_DOUBLE в файле с именем myFile.nc NetCDF 3.

Размерности новой переменной, заданной как пара, разделенная запятой, состоящая из 'Dimensions' и массива ячеек. Массив ячеек перечисляет имя размерности как вектор символов или скаляр строки, сопровождаемый его числовой длиной в этой форме: {dname1,dlength1,dname2,dlength2, ...}. Вход dname1 является именем первой размерности, заданной как вектор символов или скаляр строки, dlength1 является длиной первой размерности, dname2 является именем второго измерения и так далее. Если размерность существует, указывая, что ее длина является дополнительной. Переменная с одной размерностью всегда обрабатывается как вектор-столбец.

Используйте Inf, чтобы задать неограниченную размерность. Файл формата netcdf4 может иметь любое количество неограниченных размерностей в любом порядке. Все другие форматы могут иметь только одну неограниченную размерность на файл, и это должно быть задано в последний раз в массиве ячеек.

nccreate создает размерность в том же местоположении как переменная. Для файлов формата netcdf4 можно задать другое место для размерности с помощью полностью определенного имени размерности.

Пример: 'Dimensions',{'dim1',100,'dim2',150,'dim3',Inf}

Тип данных MATLAB, заданный как пара, разделенная запятой, состоящая из 'Datatype' и вектора символов или скаляра строки, содержащего имя типа данных. Когда nccreate создает переменную в файле NetCDF, это использует соответствующий тип данных NetCDF. Эта таблица приводит допустимые значения для 'Datatype' и соответствующего типа переменной NetCDF, который создает nccreate.

Значение DatatypeТип переменной NetCDF
'double'NC_DOUBLE
'single'NC_FLOAT
'int64'NC_INT64*
'uint64'NC_UINT64*
'int32'NC_INT
'uint32'NC_UINT*
'int16'NC_SHORT
'uint16'NC_USHORT*
'int8'NC_BYTE
'uint8'NC_UBYTE*
'char'NC_CHAR

* Эти типы данных только доступны, когда файл является файлом формата netcdf4.

Пример: 'Datatype','uint16'

Формат файла NetCDF, заданный как пара, разделенная запятой, состоящая из 'Format' и одно из этих значений.

Значение FormatОписание
'classic'NetCDF 3
'64bit'NetCDF 3, с 64-битными смещениями
'netcdf4_classic'Модель классики NetCDF 4
'netcdf4'Модель NetCDF 4 (Используют этот формат, чтобы включить иерархию группы),

Если varname задает группу (например, '/grid3/temperature'), то nccreate устанавливает значение Format к 'netcdf4'.

Пример: 'Format','classic'

Заменяющее значение для отсутствующих значений, заданных как пара, разделенная запятой, состоящая из 'FillValue' и скаляра или 'disable'. Значение по умолчанию задано библиотекой NetCDF. Чтобы отключить заменяющие значения, задайте 'FillValue','disable'.

Этот аргумент доступен для netcdf4 или форматов netcdf4_classic только.

Пример: 'FillValue',NaN

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

Разделите размер на блоки по каждому измерению, заданному как пара, разделенная запятой, состоящая из 'ChunkSize' и вектора. Первый элемент задает количество строк, второй элемент задает количество столбцов, третий элемент задает длину третьей размерности и так далее. Значение по умолчанию задано библиотекой NetCDF.

Этот аргумент доступен для netcdf4 или форматов netcdf4_classic только.

Пример: 'ChunkSize',[5 6 9]

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

Объем сжатия, заданного как пара, разделенная запятой, состоящая из 'DeflateLevel' и скалярного значения между 0 и 9. 0 не указывает ни на какое сжатие, и 9 указывает на большую часть сжатия.

Этот аргумент доступен для netcdf4 или форматов netcdf4_classic только.

Пример: 'DeflateLevel',5

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

Состояние фильтра перестановки, заданного как пара, разделенная запятой, состоящая из 'Shuffle' и false или true. false отключает фильтр перестановки, и true включает его. Фильтр перестановки может помочь со сжатием целочисленных данных путем изменения порядка байтов в потоке данных.

Этот аргумент доступен для netcdf4 или форматов netcdf4_classic только.

Пример: 'Shuffle',true

Типы данных: логический

Введенный в R2011a