描述 NetCDF 文件 (多维)

摘要

描述输入 netCDF 数据集的性质和内容。 列出了所有变量及其维度和属性。

使用情况

  • 该工具支持带有 .nc.nc4 扩展名的 netCDF-3 和 netCDF-4 格式。

  • 该工具生成地理处理消息和可选的 Markdown 文件以供输出。

    此工具的地理处理消息描述了输入 netCDF 文件的特征和内容。 这些消息包含如下关于 netCDF 文件的信息:

    • 输入 netCDF 文件路径。
    • “尺寸”表描述了变量的形状。 其中包含三列:Dimension、Size 和 Variables。 每一行指定了尺寸名称、其尺寸大小及相关变量。
    • “变量”表列出了变量信息。 其中包含四列:Variable、Data Type、Dimensions 和 Attributes。 每个变量可以与一个或多个尺寸相关联,并能存储不同类型的数据(如整型、浮点型或字符)。 属性提供了关于变量中数据的上下文和细节,包括计量单位、描述及缺失值的信息。
    • “全局属性”表记录了元数据。 其中包含两列:Attribute Name 和 Attribute Value。 该表用于存储常规信息,例如数据集的来源、约定、历史记录和其他详细信息。

  • 如果为输出描述文件Python 中的 out_file)参数提供值,工具将生成一个表格,包含地理处理消息的内容。 输出描述文件可另存为 .txt.cdl.md 格式。 如果未指定文件扩展名,输出文件将默认保存为 .txt 文件。

  • 该工具不支持读取由“时空特征挖掘”工具箱生成的 netCDF 文件。 使用描述时空立方体工具,该工具提供了增强功能来描述此类型文件的内容。

参数

标注说明数据类型
输入 netCDF 文件

将要描述的输入 netCDF 文件。

File
输出描述文件
(可选)

输出描述 Markdown 文件的名称,该文件将包含有关输入 netCDF 文件的摘要信息。 指定带有 .md.cdl.txt 扩展名的文件名。

File

arcpy.md.DescribeNetCDFFile(in_netCDF_file, {out_file})
名称说明数据类型
in_netCDF_file

将要描述的输入 netCDF 文件。

File
out_file
(可选)

输出描述 Markdown 文件的名称,该文件将包含有关输入 netCDF 文件的摘要信息。 指定带有 .md.cdl.txt 扩展名的文件名。

File

代码示例

DescribeNetCDFFile 示例 1(Python 窗口)

描述 netCDF 文件。

import arcpy    
arcpy.md.DescribeNetCDFFile(in_netCDF_file=r"C:\example\airtemp.nc")
DescribeNetCDFFile 示例 2(独立脚本)

描述 netCDF 文件。

# Name: DescribeNetCDFFile.py  
# Description: Describe a NetCDF dataset.  

# Import system modules 
import arcpy 
 
# Set environment settings  
arcpy.env.workspace = "C:/data" 

# Set a variable 
in_netCDF_file = r"C:\example\airtemp.nc" 
out_file = r"C:\example\summary.md" 

# Run DescribeNetCDFFile 
arcpy.md.DescribeNetCDFFile(in_netCDF_file, out_file)

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题