exponenta event banner

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 должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

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

Размеры новой переменной, указанной как разделенная запятыми пара, состоящая из 'Dimensions' и массив ячеек. Массив ячеек перечисляет имя измерения как вектор символов или строковый скаляр, за которым следует числовая длина, в следующей форме: {dname1,dlength1,dname2,dlength2, ...}. dname1 input - имя первого измерения, указанное как вектор символа или скаляр строки, 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