netcdf.putAtt

Запишите атрибут NetCDF

Синтаксис

netcdf.putAtt(ncid,varid,attrname,attrvalue) netcdf.putAtt(ncid,varid,attrname,attrvalue,xtype)

Описание

netcdf.putAtt(ncid,varid,attrname,attrvalue) пишет атрибут под названием attrname со значением attrvalue к переменной NetCDF, заданной varid. Чтобы задать глобальный атрибут, используйте netcdf.getConstant('NC_GLOBAL') для varid.

ncid идентификатор файла NetCDF, возвращенный netcdf.create или netcdf.open.

netcdf.putAtt(ncid,varid,attrname,attrvalue,xtype) записи attrvalue когда тип данных задан в xtype. Задайте значение xtype как вектор символов или строковый скаляр, содержащий одно из следующих значений, или как эквивалентное числовое значение, возвращенное netcdf.getConstant функция:

Значение `xtype`	MATLAB^® Класс
`NC_DOUBLE`	`'double'`
`NC_FLOAT`	`'single'`
`NC_INT64` (NETCDF только 4 файла)	`'int64'`
`NC_UINT64` (NETCDF только 4 файла)	`'uint64'`
`NC_INT`	`'int32'`
`NC_UINT` (NETCDF только 4 файла)	`'uint32'`
`NC_SHORT`	`'int16'`
`NC_USHORT` (NETCDF только 4 файла)	`'uint16'`
`NC_BYTE`	`'int8'`
`NC_UBYTE` (NETCDF только 4 файла)	`'uint8'`
`NC_CHAR`	`'char'`
`NC_STRING` (NETCDF только 4 файла)	`'string'`

Примечание

Вы не можете использовать netcdf.putAtt установить '_FillValue' атрибут файлов NetCDF4. Используйте netcdf.defVarFill функционируйте, чтобы установить значение заливки для переменной.

netcdf.putAtt функция соответствует нескольким функциям ввода-вывода атрибута в API библиотеки NetCDF C. Чтобы использовать эту функцию, вы должны ознакомиться с парадигмой программирования netCDF.

Примеры

свернуть все

Задайте размерность и переменную

Этот пример создает новый файл NetCDF, задает размерность и переменную, добавляют данные к переменной, и затем создают атрибут, сопоставленный с переменной. Чтобы запустить этот пример, у вас должно быть разрешение средства записи в вашем текущем каталоге.

% Create a variable in the workspace.
my_vardata = linspace(0,50,50);

% Create a netCDF file.
ncid = netcdf.create('foo.nc','NC_WRITE');

% Define a dimension in the file.
dimid = netcdf.defDim(ncid,'my_dim',50);
 
% Define a new variable in the file.
varid = netcdf.defVar(ncid,'my_var','double',dimid);

% Leave define mode and enter data mode to write data.
netcdf.endDef(ncid);

% Write data to variable.
netcdf.putVar(ncid,varid,my_vardata);

% Re-enter define mode.
netcdf.reDef(ncid);

% Create an attribute associated with the variable.
netcdf.putAtt(ncid,0,'my_att',10);

% Verify that the attribute was created.
[xtype xlen] = netcdf.inqAtt(ncid,0,'my_att')

xtype =

     6


xlen =

     1

Задайте глобальный атрибут

Этот пример создает новый файл NetCDF, задает глобальный атрибут и присваивает значение атрибуту.

ncid = netcdf.create('myfile.nc','CLOBBER');
varid = netcdf.getConstant('GLOBAL');
netcdf.putAtt(ncid,varid,'creation_date',datestr(now));
netcdf.close(ncid);

Запишите массив строк в глобальный атрибут

Запишите массив строк как тип NC_STRING к глобальному атрибуту в файле NetCDF-4. Затем возвратите значение глобального атрибута.

Создайте файл NetCDF-4 и запишите массиву строк ["°F","°C"] как значение глобального атрибута Units.

ncid = netcdf.create("myfile.nc","NETCDF4");
netcdf.putAtt(ncid, netcdf.getConstant("NC_GLOBAL"),"Units", ["°F","°C"])
netcdf.close(ncid)

Возвратите значение глобального атрибута, затем закройте файл NetCDF-4.

ncid = netcdf.open("myfile.nc");
netcdf.getAtt(ncid, netcdf.getConstant("NC_GLOBAL"), "Units")
netcdf.close(ncid)

Запись данных, чтобы приписать как данные о строке

Запишите данные к глобальному атрибуту в файле NetCDF-4 как данные о строке.

Создайте файл NetCDF-4. Затем запишите вектору символов 'March' как вводят 'NC_STRING' к глобальному атрибуту Month.

ncid = netcdf.create("myfile.nc", "NETCDF4");
netcdf.putAtt(ncid, netcdf.getConstant("NC_GLOBAL"),...
      "Month", 'March', 'NC_STRING')
netcdf.close(ncid)

Возвратите значение глобального атрибута Month, затем закройте файл NetCDF-4.

ncid = netcdf.open("myfile.nc");
netcdf.getAtt(ncid, netcdf.getConstant("NC_GLOBAL"), "Month")
netcdf.close(ncid)

Документация