ncreadatt
读取 netCDF 数据源中的属性值
说明
读取 attvalue
= ncreadatt(source
,location
,attname
)source
中 location
所指定组或变量的 netCDF 属性 attname
。返回的属性值属于与 attname
的 netCDF 数据类型最匹配的 MATLAB® 数据类型。有关 MATLAB 如何确定最佳匹配的详细信息,请参阅NetCDF 到 MATLAB 数据类型的转换。
示例
读取全局属性
读取 netCDF 文件 example.nc
的 creation_date
全局属性。
creationDate = ncreadatt("example.nc","/","creation_date")
creationDate = '29-Mar-2010'
读取变量属性
读取与 temperature
变量相关联的 scale_factor
属性。
scaleFactor = ncreadatt("example.nc","temperature","scale_factor")
scaleFactor = 1.8000
读取组属性
读取与 /grid2
组相关联的 description
属性。您只能从 netcdf4
格式的文件中读取组属性。
groupDescription = ncreadatt("example.nc","/grid2","description")
groupDescription = 'This is another group attribute.'
输入参数
source
— netCDF 数据源的名称
字符串标量 | 字符向量
netCDF 数据源的名称,指定为字符串标量或字符向量。source
参数可以是以下值之一:
本地 netCDF 源的路径
远程 OPeNDAP netCDF 数据源的 OPeNDAP URL
远程 netCDF 源的 HTTP URL,在 URL 的末尾附加
#mode=bytes
以支持字节范围读取注意
字节范围读取比从其他来源读取要慢。有关字节范围读取的更多详细信息,请参阅 netCDF 文档。
示例: "myNetCDFfile.nc"
示例: "http://
host_name
/netcdf_filename
#mode=bytes"
location
— 变量或组的位置
字符串标量 | 字符向量
netCDF 数据源中变量或组的位置,指定为字符串标量或字符向量。要读取全局属性,请将 location
设置为 "/"
(正斜杠)。
示例: "myVar"
示例: "/myGrp/mySubGrp/myNestedVar"
示例: "myGrp"
示例: "/myGrp/mySubGrp"
attname
— 属性名称
字符串标量 | 字符向量
要读取的属性名称,指定为字符串标量或字符向量。
示例: "myAttribute"
详细信息
NetCDF 到 MATLAB 数据类型的转换
netCDF 相关的 MATLAB 函数根据此表自动选择与 netCDF 数据类型最匹配的 MATLAB 数据类型。
NetCDF 数据类型 | MATLAB 数据类型 |
---|---|
NC_DOUBLE | double |
NC_FLOAT | single |
NC_INT | int32 |
NC_SHORT | int16 |
NC_BYTE | int8 |
NC_CHAR | char |
NC_STRING (*) | string |
NC_INT64 (*) | int64 |
NC_UINT64 (*) | uint64 |
NC_UINT (*) | uint32 |
NC_USHORT (*) | uint16 |
NC_UBYTE (*) | uint8 |
用户定义的 NC_VLEN 类型 (*) | cell |
(*) 这些 netCDF 数据类型仅适用于格式为 netcdf4
的文件。
版本历史记录
在 R2011a 中推出R2022a: 远程数据集的字节范围读取
只要远程服务器支持字节范围访问,您就可以使用 ncreadatt
通过 HTTP 字节范围功能对远程数据集进行只读访问。
R2022a: 读取可变长度数组数据类型 (NC_VLEN
)
您可以从 netCDF-4 文件中读取可变长度的数组数据类型 (NC_VLEN
)。
R2021b: 读取 NC_STRING
属性
您可以从 netCDF-4 文件中读取 NC_STRING
属性。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)