nccreate

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

Описание

пример

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,Value аргументы. 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 (NETCDF только 4 файла)
'uint64'NC_UINT64 (NETCDF только 4 файла)
'int32'NC_INT
'uint32'NC_UINT (NETCDF только 4 файла)
'int16'NC_SHORT
'uint16'NC_USHORT (NETCDF только 4 файла)
'int8'NC_BYTE
'uint8'NC_UBYTE (NETCDF только 4 файла)
'char'NC_CHAR
'string'NC_STRING (NETCDF только 4 файла)

Пример: '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'. Вы не можете отключить 'FillValue' при записывании данные типа NC_STRING к NETCDF 4 файла.

Этот аргумент доступен для 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ложь отключает фильтр перестановки и true включает его. Фильтр перестановки может помочь со сжатием целочисленных данных путем изменения порядка байтов в потоке данных.

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

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

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

Ограничения

  • Вы не можете отключить 'FillValue' при записывании данные типа NC_STRING к NETCDF 4 файла.

Введенный в R2011a
Для просмотра документации необходимо авторизоваться на сайте