Main Content

本页面提供的是上一版软件的文档。当前版本中已删除对应的英文页面。

ncwriteatt

将属性写入 NetCDF 文件

全页折叠

语法

ncwriteatt(filename,location,attname,attvalue)
ncwriteatt(filename,location,attname,attvalue,'Datatype',dtype)

说明

ncwriteatt(filename,location,attname,attvalue) 创建或修改 filename 所指定的 NetCDF 文件中由 location 确定的组或变量中由 attname 指定的属性。attvalue 可以是字符向量、字符串标量、字符串数组或数值向量。

ncwriteatt(filename,location,attname,attvalue,'Datatype',dtype) 将 attvalue 作为在 dtype 中指定的数据类型写入。例如，将 'Datatype' 的值指定为 'string'，以将 attvalue 中的数据作为字符串数据写入。

输入参数

filename

字符向量或字符串标量，用于指定 NetCDF 文件的名称

location

字符向量或字符串标量，用于指定 NetCDF 文件中的组或变量。要写入全局属性，需将 location 设置成 '/'（正斜杠）。

attname

字符向量或字符串标量，用于指定 NetCDF 文件中现有属性的名称或待创建属性的名称。

attvalue

字符向量、字符串标量、字符串数组或数值向量。

Datatype

字符向量或字符串标量，指定用于写入属性值 attvalue 的数据类型。可将 'Datatype' 指定为以下值之一：'double'、'single'、'int64'、'uint64'、'int32'、'uint32'、'int16'、'uint16'、'int8'、'uint8'、'char'、'string'。

示例

全部折叠

在 NetCDF 文件中创建一个全局属性。

copyfile(which("example.nc"),"myfile.nc");
fileattrib("myfile.nc","+w");
ncdisp("myfile.nc");
ncwriteatt("myfile.nc","/","creation_date",datestr(now));
ncdisp("myfile.nc");

修改 NetCDF 文件中的现有属性。

copyfile(which("example.nc"),"myfile.nc");
fileattrib("myfile.nc","+w");
ncdisp("myfile.nc","peaks");
ncwriteatt("myfile.nc","peaks","description","Output of PEAKS");
ncdisp("myfile.nc","peaks");

将字符串数组写入 NetCDF-4 文件中的数据集属性。然后，显示属性的值。

创建一个 NetCDF-4 文件和一个名为 Temperature 的变量。然后，将字符串数组 ["°​F","°​C"] 作为名为 Units 的属性的值写入。该数组包含非 ASCII 字符串数据。

nccreate("myfile.nc","Temperature","Format","netcdf4");
ncwriteatt("myfile.nc","Temperature","Units",["°​F","°​C"]);

显示变量 Temperature 的内容。

ncdisp("myfile.nc","Temperature");

将数据作为字符串数据写入 NetCDF-4 文件中的属性。

创建一个 NetCDF-4 文件和一个名为 Temperature 的变量。然后，通过将 "Datatype" 的值指定为 "string"，将字符向量 "July" 作为 NC_STRING 类型写入名为 Months 的属性。默认情况下，ncwriteatt 将标量文本数据作为 NC_CHAR 类型写入。

nccreate("myfile.nc","Temperature","Format","netcdf4");
ncwriteatt("myfile.nc","Temperature","Months","July","Datatype","string");

读取属性 Months 的值。

ncreadatt("myfile.nc","Calendar","Months");

局限性

  • 只能使用 NetCDF-4 文件创建 NC_STRING 类型的属性。

版本历史记录

在 R2011a 中推出

全部展开

另请参阅

| | | |

主题