标注 | 说明 | 数据类型 |
输入 netCDF 文件 | 将要描述的输入 netCDF 文件。 | File |
输出描述文件 (可选) | 输出描述 Markdown 文件的名称,该文件将包含有关输入 netCDF 文件的摘要信息。 指定带有 .md、.cdl 或 .txt 扩展名的文件名。 | File |
摘要
描述输入 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 文件。 使用描述时空立方体工具,该工具提供了增强功能来描述此类型文件的内容。
参数
arcpy.md.DescribeNetCDFFile(in_netCDF_file, {out_file})
名称 | 说明 | 数据类型 |
in_netCDF_file | 将要描述的输入 netCDF 文件。 | File |
out_file (可选) | 输出描述 Markdown 文件的名称,该文件将包含有关输入 netCDF 文件的摘要信息。 指定带有 .md、.cdl 或 .txt 扩展名的文件名。 | File |
代码示例
描述 netCDF 文件。
import arcpy
arcpy.md.DescribeNetCDFFile(in_netCDF_file=r"C:\example\airtemp.nc")
描述 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: 是