要素转 NetCDF (多维)

摘要

将点要素转换为 NetCDF 文件。

使用情况

  • 默认变量名与字段至变量参数(Python 中的 fields_to_variables)中指定的输入要素字段名相同。

  • 变量的类型与字段的类型相同。

  • 特殊字段 Shape.XShape.Y字段至变量下拉列表中始终可用。 它们可分别为 x 坐标和 y 坐标指定变量名。 如果未指定变量名或者 Shape.XShape.Y 未添加到列表,则 x 坐标和 y 坐标将使用默认变量名导出。 如果要素在地理坐标系中,则 Shape.XShape.Y 的默认变量名将分别为 lonlat。 在所有其他情况下,Shape.XShape.Y 的默认变量名分别为 xy

  • 针对具有 z 值和 m 值的要素,特殊字段 Shape.ZShape.M字段至变量下拉列表中可用。 要导出 z 值和 m 值,必须将 Shape.ZShape.M 添加到列表。 Shape.ZShape.M 的默认变量名分别为 zm

  • 默认维度名称与字段至维度参数(Python 中的 fields_to_ dimensions)中指定的输入要素字段名相同。

  • 维数等于相应字段中唯一值的数量。

  • 如果没有将任何字段指定为行维度,则将在输出 netCDF 文件中创建维度 RecordID 值,其维数与要素的数量相等。

  • 字符串字段不能用于在 netCDF 文件中创建维度。

  • 当使用字段至维度参数在 netCDF 文件中使用多个字段创建维度时,输出 netCDF 文件的大小可能会变大。 确保输出位置具有足够的空间以避免工具故障。

  • 该工具将在 CF 约定后面写入变量作为离散采样几何 (DSG),例如点或轨迹。 由于此数据未格网化,因此输出 netCDF 文件中的变量不适用于创建体素图层。

参数

标注说明数据类型
输入要素

输入点要素。

Feature Layer
字段至变量

在 netCDF 文件中创建变量时将使用的字段。

四个特殊字段(Shape.X、Shape.Y、Shape.Z 和 Shape.M)可用于分别导出输入要素的 x 坐标或经度、y 坐标或纬度、z 值和 m 值。

  • 字段 - 输入要素属性表中的某个字段。
  • 变量 - netCDF 变量名
  • 单位 - 由字段表示的数据单位
Value Table
输出 netCDF 文件

待输出的 netCDF 文件。 文件名的扩展名必须是 .nc

File
维度字段
(可选)

在 netCDF 文件中创建维度时将使用的字段。

  • 字段 - 输入要素属性表中的某个字段。
  • 维度 - netCDF 维度名称
  • 单位 - 由字段表示的数据单位
Value Table

arcpy.md.FeatureToNetCDF(in_features, fields_to_variables, out_netCDF_file, {fields_to_dimensions})
名称说明数据类型
in_features

输入点要素。

Feature Layer
fields_to_variables
[[field, {variable}, {units}],...]

在 netCDF 文件中创建变量时将使用的字段。

四个特殊字段(Shape.X、Shape.Y、Shape.Z 和 Shape.M)可用于分别导出输入要素的 x 坐标或经度、y 坐标或纬度、z 值和 m 值。

  • field - 输入要素属性表中的某个字段。
  • {variable} - netCDF 变量名
  • {units} - 由字段表示的数据单位
Value Table
out_netCDF_file

待输出的 netCDF 文件。 文件名的扩展名必须是 .nc

File
fields_to_dimensions
[[field, {dimension}, {units}],...]
(可选)

在 netCDF 文件中创建维度时将使用的字段。

  • field - 输入要素属性表中的某个字段。
  • {dimension} - netCDF 维度名称
  • {units} - 由字段表示的数据单位
Value Table

代码示例

FeatureToNetCDF 示例 1(Python 窗口)

将要素类转换为 netCDF 文件。

import arcpy
arcpy.FeatureToNetCDF_md("c:/data/spotelev.shp", [["Shape.X", "lon"],
                         "degree_east", ["Shape.Y", "lat", "degree_north"],
                         ["elevation", "elevation", "meter"]],
                         "c:/output/pointelev01.nc", "id")
FeatureToNetCDF 示例 2(独立脚本)

将要素类转换为 netCDF 文件。

# FeatureToNetCDF_Ex_02.py
# Description: Converts a feature class to a netCDF file.
# Requirements: None

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data/netcdfgisdata"

# Set local variables
inFeatures = "spotelev.shp"
fieldToVariable = [["Shape.Y", "lat", "degree_north"],
                   ["elevation", "elevation", "meter"]]
outNetCDFFile = "c:/output/pointelev02.nc"
fieldToDimension = "id"

# Execute FeatureToNetCDF
arcpy.FeatureToNetCDF_md(inFeatures, fieldToVariable, outNetCDFFile, 
                         fieldToDimension)

许可信息

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

相关主题