返回顶部

更新子网 (公共设施网络)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

更新指定子网的子网表、SubnetLine 要素类和子网系统逻辑示意图中的子网信息。

对于子网表，此工具将关联子网控制器的状态更改为清洁（Is dirty属性设置为 False）。 如果在工具运行期间发现验证一致性失败或子网错误，则相关子网控制器的状态将被标记为无效（Is dirty 属性设置为无效）。 在 SubnetLine 要素类中，将生成新子网的记录，将删除已删除子网的记录，并更新已修改子网的形状和信息。 同时创建或更新子网要素的某些属性。

了解有关如何更新子网的详细信息

使用情况

  • 使用企业级地理数据库时，必须满足以下要求：

    • 公共设施网络必须注册为分支版本。
    • 输入公共设施网络必须来自公共设施网络服务。
    • 如果此工具在默认版本上运行，并且层的更新子网策略配置为不管理Is dirty属性，则更新子网操作可用于删除子网表中 Is deleted 属性设置为 true 的行。
    • 如果在默认版本上运行此工具，则将就地更新 SubnetLine 要素类的几何、子网名称属性和传播字段。 如果针对指定版本运行此工具，则默认行为（不含事件）将限制对在该版本中编辑的要素和对象的更新。 可以将编辑模式更改为使用事件（含事件）。 此选项将运行地理数据库行为，并且可以针对默认版本和指定版本在子网定义中进行设置。

      了解有关更新子网工具使用的编辑模式的详细信息

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

  • 此工具用于根据已更新子网创建或更新网络逻辑示意图（如果设置子网定义时已指定逻辑示意图模板）。

  • 运行此工具前，必须保存所有编辑内容。

  • 必须启用网络拓扑。

  • 不存在与子网要素相交的脏区。

参数

对话框Python

标注说明数据类型
输入公共设施网络

包含子网的公共设施网络。

Utility Network; Utility Network Layer
域网络

包含子网的域网络。

String
层

包含子网的层。

String
层中的所有子网
(可选)

指定是否更新层中的所有子网。 要更新层中的子网子集，请使用子网名称参数。

  • 选中 - 将更新层中的所有子网。 此选项使用异步处理通过系统 UtilityNetworkTools 地理处理服务更新子网。 此服务为公共设施网络地理处理任务而保留，并具有较长的默认超时设置。 这是默认设置。
  • 未选中 - 仅更新子网名称参数中指定的子网。

Boolean
子网名称
(可选)

将从层更新的子网的名称。 如果将使用层中的所有子网参数来更新所有子网，则将忽略此参数。 当子网表包含层级的 10,000 条或更多记录时，不会填充参数的选择列表，并且会为子网名称提供一个空字段。

String
失败后继续
(可选)

指定如果在更新多个子网时某一子网更新失败，则是否停止更新进程。

  • 选中 - 如果发生子网故障，更新过程不会停止，会继续。
  • 未选中 - 如果发生子网故障，更新过程会停止。 这是默认设置。

Boolean
条件障碍
(可选)
注：

此参数仅可用于 Python。

Value Table
函数障碍
(可选)
注：

此参数仅可用于 Python。

Value Table
包括障碍要素
(可选)
注：

此参数仅可用于 Python。

Boolean
应用可遍历性至
(可选)

指定要强制使用的可遍历性的类型。 可遍历性范围用于确定是否将在交汇点、边或这两处强制使用可遍历性。 例如，如果定义了一个用于停止追踪的条件障碍，其中 DEVICESTATUS 等于 Open 且遍历范围设置为仅边，则即使遇到开路设备，追踪也不会停止，因为 DEVICESTATUS 仅适用于交汇点。 换言之，此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • 交汇点和边—可遍历性将同时应用于交汇点和边。 这是默认设置。
  • 仅交汇点—可遍历性将仅应用于交汇点。
  • 仅边—可遍历性将仅应用于边。
注：

此参数仅可用于 Python。

String
传播程序
(可选)
注：

此参数仅可用于 Python。

Value Table

派生输出

标注说明数据类型
更新的公共设施网络

更新的公共设施网络。

Utility Network

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
名称说明数据类型
in_utility_network

包含子网的公共设施网络。

Utility Network; Utility Network Layer
domain_network

包含子网的域网络。

String
tier

包含子网的层。

String
all_subnetworks_in_tier
(可选)

指定是否更新层中的所有子网。 要更新层中的子网子集，请使用 subnetwork_name 参数。

  • ALL_SUBNETWORKS_IN_TIER—更新层中的所有子网。 此选项使用异步处理通过系统 UtilityNetworkTools 地理处理服务更新子网。 此服务为公共设施网络地理处理任务而保留，并具有较长的默认超时设置。 这是默认设置。
  • SPECIFIC_SUBNETWORK—只会更新 subnetwork_name 参数中指定的子网。
Boolean
subnetwork_name
(可选)

将从层更新的子网的名称。 如果将使用 all_subnetworks_in_tier 参数来更新所有子网，则将忽略此参数。

String
continue_on_failure
(可选)

指定如果在更新多个子网时某一子网更新失败，则是否停止更新进程。

  • CONTINUE_ON_FAILURE—如果发生子网故障，更新过程不会停止，会继续。
  • STOP_ON_FAILURE—如果发生子网故障，更新过程会停止。 这是默认设置。
Boolean
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(可选)

基于与网络属性的比较或对类别字符串的检查，对要素设置可遍历性障碍条件。 条件障碍使用网络属性、运算符和类型以及属性值。 例如，当要素的 Device Status 属性等于 Open 的特定值时，将停止追踪。 当要素满足此条件时，追踪将停止。 如果您要使用多个属性，可使用 Combine Using 参数来定义 And 或 Or 条件。

条件障碍组件如下：

  • Name - 选择按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量不同的运算符中进行选择。
  • Type - 从 name 参数指定的值中选择特定值或网络属性。
  • Value - 设置基于运算符值导致终止的输入属性类型的特定值。
  • Combine Using - 如果要添加多个属性，则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

条件障碍 Operator 值如下：

  • IS_EQUAL_TO—属性与值相等。
  • DOES_NOT_EQUAL—属性与值不相等。
  • IS_GREATER_THAN—属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO—属性大于或等于值。
  • IS_LESS_THAN—属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO—属性小于或等于值。
  • INCLUDES_THE_VALUES—按位与运算，其中值中的所有位都存在于属性中（按位与 == 值）。
  • DOES_NOT_INCLUDE_THE_VALUES—按位与运算，其中并非值中的所有位都存在于属性中（按位与 != 值）。
  • INCLUDES_ANY—按位与运算，其中值中的至少一个位存在于属性中（按位与 == True）。
  • DOES_NOT_INCLUDE_ANY—按位与运算，其中值中的所有位均不存在于属性中（按位与 == False）。

条件障碍 type 选项如下：

  • SPECIFIC_VALUE—按特定值过滤。
  • NETWORK_ATTRIBUTE—按网络属性过滤。

Combine Using 值如下：

  • AND—合并条件障碍。
  • OR—满足任一条件障碍时使用。

了解有关使用多条件表达式的详细信息

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(可选)

基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。 例如，所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时，追踪将停止。

函数障碍组件如下：

  • Function - 从大量不同的计算函数中进行选择。
  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量不同的运算符中进行选择。
  • Value - 设置将导致终止的输入属性类型（若发现）的特定值。
  • Use Local Values - 计算每个方向的值，而不是整体全局值，例如计算 Shape length 总和的函数障碍，其中，如果值大于或等于 4，则追踪终止。 在全局情况下，遍历两条值为 2 的边之后，形状长度总和即已达到 4，因此追踪会停止。 如果使用本地值，每条路径上的本地值会变化，因此追踪会持续得更远。

  • TRUE—将使用局部值。
  • FALSE—将使用全局值。 这是默认设置。

函数障碍 function 选项的可能值如下：

  • AVERAGE—输入值的平均值。
  • COUNT—要素数目。
  • MAX—输入值的最大值。
  • MIN—输入值的最小值。
  • ADD—加上这些值。
  • SUBTRACT—减去这些值。 子网控制器和循环追踪类型不支持减函数。

例如，起点要素的值为 20。 下一个要素的值为 30。 如果使用 Minimum 函数，则结果为 20；使用 Maximum 函数，结果为 30；使用 Add 函数，结果为 50；使用 Average 函数，结果为 25；使用 Count 函数，结果为 2；使用 Subtract 函数，结果为 -10。

函数障碍 operator 值选项如下：

  • IS_EQUAL_TO—属性与值相等。
  • DOES_NOT_EQUAL—属性与值不相等。
  • IS_GREATER_THAN—属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO—属性大于或等于值。
  • IS_LESS_THAN—属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO—属性小于或等于值。
  • INCLUDES_THE_VALUES—按位与运算，其中值中的所有位都存在于属性中（按位与 == 值）。
  • DOES_NOT_INCLUDE_THE_VALUES—按位与运算，其中并非值中的所有位都存在于属性中（按位与 != 值）。
  • INCLUDES_ANY—按位与运算，其中值中的至少一个位存在于属性中（按位与 == True）。
  • DOES_NOT_INCLUDE_ANY—按位与运算，其中值中的所有位均不存在于属性中（按位与 == False）。
Value Table
include_barriers
(可选)

指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设，可遍历性障碍仍可选。

  • INCLUDE_BARRIERS—追踪结果中将包含可遍历性障碍。 这是默认设置。
  • EXCLUDE_BARRIERS—追踪结果中将不会包含可遍历性障碍。
Boolean
traversability_scope
(可选)

指定要强制使用的可遍历性的类型。 可遍历性范围用于确定是否将在交汇点、边或这两处强制使用可遍历性。 例如，如果定义了一个用于停止追踪的条件障碍，其中 DEVICESTATUS 等于 Open 且遍历范围设置为仅边，则即使遇到开路设备，追踪也不会停止，因为 DEVICESTATUS 仅适用于交汇点。 换言之，此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • BOTH_JUNCTIONS_AND_EDGES—可遍历性将同时应用于交汇点和边。 这是默认设置。
  • JUNCTIONS_ONLY—可遍历性将仅应用于交汇点。
  • EDGES_ONLY—可遍历性将仅应用于边。
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(可选)

指定要传播的网络属性以及传播将在追踪过程中的发生方式。 传播的类属性表示子网控制器上已传播至子网余下要素的关键值。 例如，在配电模型中，您可传播相位值。

传播程序组件如下：

  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Substitution Attribute - 使用替换值而不是 bitset 网络属性值。 替换是基于正在传递的网络属性中的位数进行编码的。 替换是指同相位的某个位到另一个位的映射。 例如对于相 AC 而言，可通过一个替换将位 A 映射到 B，将位 C 映射到 null。 在该示例中，1010（相 AC）的替换是 0000-0010-0000-0000 (512)。 该替换将捕捉映射，以通知您相 A 被映射到 B，且相 C 被映射到 null 而非相反（即相 A 未映射到 null，且相 C 未映射到 B）。
  • Function - 从大量计算函数中进行选择。
  • Operator - 从大量运算符中进行选择。
  • Value - 提供会基于运算符值导致终止的输入属性类型的特定值。

传播程序 function 值选项如下：

  • PROPAGATED_BITWISE_AND—比较一个要素与下一个要素的值。
  • PROPAGATED_MIN—获取最小值。
  • PROPAGATED_MAX—获取最大值。

传播程序 operator 值选项如下：

  • IS_EQUAL_TO—属性与值相等。
  • DOES_NOT_EQUAL—属性与值不相等。
  • IS_GREATER_THAN—属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO—属性大于或等于值。
  • IS_LESS_THAN—属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO—属性小于或等于值。
  • INCLUDES_THE_VALUES—按位与运算，其中值中的所有位都存在于属性中（按位与 == 值）。
  • DOES_NOT_INCLUDE_THE_VALUES—按位与运算，其中并非值中的所有位都存在于属性中（按位与 != 值）。
  • INCLUDES_ANY—按位与运算，其中值中的至少一个位存在于属性中（按位与 == True）。
  • DOES_NOT_INCLUDE_ANY—按位与运算，其中值中的所有位均不存在于属性中（按位与 == False）。
Value Table

派生输出

名称说明数据类型
out_utility_network

更新的公共设施网络。

Utility Network

代码示例

UpdateSubnetwork 示例 1（Python 窗口）

更新名为 RMT004 的特定子网。

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
UpdateSubnetwork 示例 2（Python 窗口）

更新 Medium Voltage 层中的所有子网。

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

环境

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

许可信息

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

相关主题

  • 公共设施网络工具箱概述
  • 查找地理处理工具
  • 导出子网
  • 追踪
  • 更新已连接
  • 验证网络拓扑

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息