创建 NetCDF 表视图 (多维)

摘要

根据 NetCDF 文件创建表格视图。

使用情况

  • 表视图是存储在内存中的表,与“ArcGIS Pro 内容”窗格中的独立表相同。

  • 在当前 Windows 会话中,表视图可以用作其他地理处理工具的输入。 在退出 Windows 后,内存中的表将会被移除。 要将表视图保存到后续的 Windows 会话可用的永久表中,可使用复制行工具。

  • 此工具支持具有 .nc.nc4 扩展名的 netCDF 文件。 不支持 .nc4 文件中位于组内的组变量和维度。 仅支持组外的变量和维度。

  • 如果输入相同的表视图名称,则现有表视图将被覆盖。

  • 表视图中的记录数等于行维度中唯一值的数量。 如果选择了多个维度,则记录数将是这些维度中唯一值数量的乘积。

  • 如果未指定行维度,则输出表中将仅包含一条记录。 字段中的值表示由维度值对所指定的部分。

  • 字段类型由 NetCDF 变量和维度类型确定。

  • 非行维度的第一个值用于创建多维变量的默认表视图。

  • 在 ArcGIS 中无法使用已分配给 netCDF 文件的时间坐标变量的日历属性值 noleap365_day

  • NetCDF 文件中变量的 missing_value_FillValue 属性所表示的值在输出表视图中将显示为 null。

参数

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

待输入的 NetCDF 文件。

File
变量

在表视图中创建字段时使用的 netCDF 变量。

String
输出表视图

输出表视图的名称。

Table View
行维度
(可选)

在表视图中创建包含唯一值的字段时使用的 netCDF 维度。 此处设置的维度决定了表视图中的行数和要显示的字段。

例如,如果 stationID 是 netCDF 文件中的一个维度且具有 10 个值,则通过将 stationID 设置为要使用的维度,将可以在表视图中创建 10 行。 如果当前使用 stationID 和时间,且存在 3 个时间片,则将在表视图中创建 30 行。

String
纬度值
(可选)

指定部分多维变量时使用的一组维度值对。

  • 维度 - netCDF 维度。
  • - 可用的维度值。
Value Table
值选择方法
(可选)

指定将使用的维度值选择方法。

  • 按值输入值将与实际维度值匹配。
  • 按索引输入值将与维度值的位置或索引匹配。 索引的第一个值为 0;即位置从 0 开始。
String

arcpy.management.MakeNetCDFTableView(in_netCDF_file, variable, out_table_view, {row_dimension}, {dimension_values}, {value_selection_method})
名称说明数据类型
in_netCDF_file

待输入的 NetCDF 文件。

File
variable
[variable,...]

在表视图中创建字段时使用的 netCDF 变量。

String
out_table_view

输出表视图的名称。

Table View
row_dimension
[row_dimension,...]
(可选)

在表视图中创建包含唯一值的字段时使用的 netCDF 维度。 此处设置的维度决定了表视图中的行数和要显示的字段。

例如,如果 stationID 是 netCDF 文件中的一个维度且具有 10 个值,则通过将 stationID 设置为要使用的维度,将可以在表视图中创建 10 行。 如果当前使用 stationID 和时间,且存在 3 个时间片,则将在表视图中创建 30 行。

String
dimension_values
[[dimension {value}],...]
(可选)

指定部分多维变量时使用的一组维度值对。

  • dimension - netCDF 维度。
  • {value} - 可用的维度值。
Value Table
value_selection_method
(可选)

指定将使用的维度值选择方法。

  • BY_VALUE输入值将与实际维度值匹配。
  • BY_INDEX输入值将与维度值的位置或索引匹配。 索引的第一个值为 0;即位置从 0 开始。
String

代码示例

MakeNetCDFTableView 示例 1(Python 窗口)

根据 NetCDF 文件创建表视图。

import arcpy
arcpy.MakeNetCDFTableView_md("C:/data/netcdf/precipmonmean.nc","precip",
                             "precipmonmeantable","time")
MakeNetCDFTableView 示例 2(独立脚本)

根据 NetCDF 文件创建表视图。

# MakeNetCDFTableView_Ex_02.py
# Description: Create a table view from a netCDF file.
# Requirements: None

#Import system modules
import arcpy

# Set local variables
inNetCDFFile = "c:/data/netcdf/precipmonmean.nc"
variable = "precip;humidity"
outTableView = "precipmonmeantable"
rowDimension = "time"
dimensionValue = ""
valueSelectionMethod = ""

# Execute MakeNetCDFTableView
arcpy.MakeNetCDFTableView_md(inNetCDFFile, variable, outTableView, rowDimension, 
                             dimensionValue,valueSelectionMethod)