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'

Имя новой переменной в виде символа vectorr или строкового скаляра.

Пример: 'myVar'

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

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

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

Использование Inf для задания неограниченной размерности. A 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

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

Введенный в R2011a