Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

ncreadatt

读取 netCDF 数据源中的属性值

    说明

    示例

    attvalue = ncreadatt(source,location,attname) 读取 sourcelocation 所指定组或变量的 netCDF 属性 attname。返回的属性值属于与 attname 的 netCDF 数据类型最匹配的 MATLAB® 数据类型。有关 MATLAB 如何确定最佳匹配的详细信息,请参阅NetCDF 到 MATLAB 数据类型的转换

    示例

    全部折叠

    读取 netCDF 文件 example.nccreation_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.'
    

    输入参数

    全部折叠

    netCDF 数据源的名称,指定为字符串标量或字符向量。source 参数可以是以下值之一:

    • 本地 netCDF 源的路径

    • 远程 OPeNDAP netCDF 数据源的 OPeNDAP URL

    • 远程 netCDF 源的 HTTP URL,在 URL 的末尾附加 #mode=bytes 以支持字节范围读取

      注意

      字节范围读取比从其他来源读取要慢。有关字节范围读取的更多详细信息,请参阅 netCDF 文档。

    示例: "myNetCDFfile.nc"

    示例: "http://host_name/netcdf_filename#mode=bytes"

    netCDF 数据源中变量或组的位置,指定为字符串标量或字符向量。要读取全局属性,请将 location 设置为 "/"(正斜杠)。

    示例: "myVar"

    示例: "/myGrp/mySubGrp/myNestedVar"

    示例: "myGrp"

    示例: "/myGrp/mySubGrp"

    要读取的属性名称,指定为字符串标量或字符向量。

    示例: "myAttribute"

    详细信息

    全部折叠

    NetCDF 到 MATLAB 数据类型的转换

    netCDF 相关的 MATLAB 函数根据此表自动选择与 netCDF 数据类型最匹配的 MATLAB 数据类型。

    NetCDF 数据类型MATLAB 数据类型
    NC_DOUBLEdouble
    NC_FLOATsingle
    NC_INTint32
    NC_SHORTint16
    NC_BYTEint8
    NC_CHARchar
    NC_STRING (*)string
    NC_INT64 (*)int64
    NC_UINT64 (*)uint64
    NC_UINT (*)uint32
    NC_USHORT (*)uint16
    NC_UBYTE (*)uint8
    用户定义的 NC_VLEN 类型 (*)cell

    (*) 这些 netCDF 数据类型仅适用于格式为 netcdf4 的文件。

    版本历史记录

    在 R2011a 中推出

    全部展开