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

Пример: nccreate ('myFile.nc', 'Var1', 'Тип данных', 'дважды', ' format ', 'классика') создает переменную по имени Var1 типа NC_DOUBLE в файле с именем myFile.nc NetCDF 3.

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

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

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

Пример: 'Размерности', {'dim1', 100, 'dim2', 150, 'dim3', Inf}

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

Значение DatatypeТип переменной NetCDF
'double'NC_DOUBLE
единственныйNC_FLOAT
int64NC_INT64*
uint64NC_UINT64*
int32NC_INT
uint32NC_UINT*
int16NC_SHORT
uint16NC_USHORT*
int8NC_BYTE
uint8NC_UBYTE*
'char'NC_CHAR

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

Пример: 'Тип данных', '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 ', 'классика'

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

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

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

Типы данных: единственный | удваиваются | 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 только.

Пример: 'Переставьте', верный

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

Введенный в R2011a

Была ли эта тема полезной?