计算聚类键 (公共设施网络)

摘要

将使用整数值来填充所有公共设施网络类上的 CLUSTERKEY 属性字段，以简化对网络拓扑中的要素和对象进行分组。

在处理非空间交汇点和边对象时，聚类键可以在公共设施网络中更有效地执行分析操作。 网络拓扑在启用时会使用聚类键，这在运行查询网络拓扑的操作（例如追踪）时非常有用。

使用情况

• 必须禁用网络拓扑。 启用网络拓扑以更新并使用网络拓扑中的聚类键。

• 公共设施网络方案必须包含所有类的 CLUSTERKEY 属性。 使用启用聚类键工具向公共设施网络版本 4 至 7 中的类添加属性字段。

• 许可：

  必须为活动门户账户分配 ArcGIS Advanced Editing 用户类型扩展模块，才能在企业级部署中使用此工具。

  了解有关如何使用聚类键的详细信息

参数

对话框

标注	说明	数据类型
输入公共设施网络	将添加聚类键的公共设施网络。	Utility Network; Utility Network Layer
覆盖 (可选)	指定是否将使用新值覆盖现有聚类键值。 选中 - 将覆盖指定范围中所有类的现有聚类键值。 未选中 - 将不会覆盖指定范围中类的现有聚类键值。 这是默认设置。	Boolean
范围 (可选)	将用于生成聚类键的地理范围。 如果未提供任何范围，则该工具将使用公共设施网络的完整范围。 当前显示范围 - 范围基于活动地图或场景。 绘制范围 - 范围将基于在地图或场景上绘制的矩形。 图层范围 - 范围基于活动地图图层。 选择可用图层或者使用所有图层中的数据范围选项。 每个地图图层具有以下选项： 所有要素 - 所有要素的范围。 选定要素 - 选定要素的范围。 可见要素 - 可见要素的范围。 浏览 - 范围将基于数据集。 输入的交集 - 范围将为所有输入的相交范围。 输入的并集 - 范围将为所有输入的合并范围。 剪贴板 - 可在剪贴板中复制和粘贴范围。 复制范围 - 将范围和坐标系复制到剪贴板。 粘贴范围 - 从剪贴板粘贴范围和坐标系。 如果剪贴板不包含坐标系，则范围将使用地图的坐标系。 重置范围 - 将范围重置为默认值。	Extent

派生输出

标注	说明	数据类型
输出公共设施网络	更新的公共设施网络。	Utility Network

Python

arcpy.un.CalculateClusterKeys(in_utility_network, {in_overwrite_values}, {in_extent})

名称	说明	数据类型
in_utility_network	将添加聚类键的公共设施网络。	Utility Network; Utility Network Layer
in_overwrite_values (可选)	指定是否使用指定范围的新值覆盖现有聚类键值。 OVERWRITE_VALUES—将覆盖指定范围中所有类的现有聚类键值。 DO_NOT_OVERWRITE_VALUES—将不会覆盖指定范围中类的现有聚类键值。 这是默认设置。	Boolean
in_extent (可选)	将用于生成聚类键的地理范围。 如果未提供任何范围，则该工具将使用公共设施网络的完整范围。 MAXOF - 将使用的所有输入的最大范围。 MINOF - 将使用的所有输入共用的最小范围。 DISPLAY - 范围与可见显示范围相等。 图层名称 - 将使用指定图层的范围。 Extent 对象 - 将使用指定对象的范围。 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min，y-min，x-max，y-max 的顺序表示。	Extent

派生输出

名称	说明	数据类型
out_utility_network	更新的公共设施网络。	Utility Network

代码示例

CalculateClusterKeys 示例（Python 窗口）

为公共设施网络 My Utility Network 的完整范围计算聚类键。

import arcpy 
arcpy.un.CalculateClusterKeys('My Utility Network', 'DO_NOT_OVERWRITE_VALUES',
                              '-10210419.36935838 2192709.92528272 -1010791.46945935 2462417.33676915')

环境

此工具不使用任何地理处理环境。

许可信息

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