要素至 NetCDF (多维)

摘要

将点要素类转换为 NetCDF 文件。

使用情况

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

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

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

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

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

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

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

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

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

参数

对话框

标注	说明	数据类型
输入要素	输入点要素类。	Feature Layer
字段至变量	在 netCDF 文件中创建变量时使用的字段。 使用四个特殊字段（Shape.X、Shape.Y、Shape.Z 和 Shape.M）可以分别导出输入要素的 x 坐标或经度、y 坐标或纬度、Z 值和 M 值。 Field - 输入要素属性表中的某个字段。 Variable - netCDF 变量名 Units - 由字段表示的数据的单位	Value Table
输出 netCDF 文件	输出的 netCDF 文件。 文件名的扩展名必须是 .nc。	File
字段至维度 (可选)	在 netCDF 文件中创建维度时使用的字段。 Field - 输入要素属性表中的某个字段。 Dimension - netCDF 维度名称 Units - 由字段表示的数据的单位	Value Table

Python

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: 是