添加终端配置 (公共设施网络)

描述

用于向现有公共设施网络添加终端配置。

带有终端的要素需要约束来定义设备或交汇点对象的内部连通性的有效配置。此工具可用于向公共设施网络添加新的终端配置，稍后可以使用设置终端配置工具将其分配给资产组或资产类型级别的类。

使用方法

• 通过分配终端配置，可以在设备或交汇点对象上配置终端。只能向支持终端的各个资产类型分配一个终端配置。

• 要素上的终端具有方向性设置。终端可以设置为定向（仅允许一个流动方向）或双向（允许两个流向）。

• 最少必须指定 2 个终端，最多可以指定 8 个终端。终端名称应该是有意义的描述，例如高压侧或源端。

• 对于具有三个或四个终端的要素，可以定义有效配置。该操作用于处理复杂的开关设备，您需要在这些开关设备中限制终端对之间的流动路径。例如，在终端名称为 A、B、C 和 D 的四终端设备中，您可能希望允许从 A 流向 B 和 C，但不允许从 A 流到 D。

• 必须禁用网络拓扑。

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

  • 此工具在执行时必须连接到默认版本。
  • 输入公共设施网络参数值必须来自作为数据库公共设施网络所有者建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者。

语法

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})

参数	说明	数据类型
in_utility_network	将添加终端配置的输入公共设施网络。	Utility Network; Utility Network Layer
terminal_configuration_name	终端配置的名称。	String
traversability_model	指定终端配置的方向性。定向可遍历性模型意味着终端的流动仅有一个方向。双向可遍历性模型意味着终端允许双向流动。 DIRECTIONAL —仅允许一个流向。 BIDIRECTIONAL —允许两个流向。	String
terminals_directional [[name, upstream],...] （可选）	每个定向终端的名称和方向流。最少必须指定 2 个终端，最多可以指定 8 个终端。每个终端的名称不能超过 32 个字符。如果 traversability_model 参数值为 DIRECTIONAL，则此参数为必需项。 Name - 提供终端的名称。 Upstream - 指示终端为上游或下游。 True - 终端为上游。 False - 终端为下游。	Value Table
terminals_bidirectional [[name],...] （可选）	每个双向终端的名称。最少必须指定 2 个终端，最多可以指定 8 个终端。每个终端的名称不能超过 32 个字符。如果方向性参数值为双向（在 Python 中为 traversability_model = "BIDIRECTIONAL"），则此参数为必需项。	Value Table
valid_paths [[Name, [Value]],...] （可选）	终端配置的有效路径的名称。对于双向可遍历性，如果存在三个或更多终端，则需要此参数。如果使用定向可遍历性，则其中一个终端必须为上游，才能具有有效配置。必须设置有效路径才能指示设备或交汇点对象内要遍历的资源的有效路径。为每个有效路径提供名称并指定值。 名称 - 有效路径的名称。 值 - 有效路径的值。 全部 - 所有路径均有效。 无 - 所有路径均无效。 终端对 - 从一个终端到另一个终端的单一路径，例如，A-B。 终端对集合 - 从一个终端到另一个终端的单一路径集合，例如，A-B、A-C。	Value Table
default_path （可选）	有效配置的默认路径。该路径将分配至将此终端配置分配至其资产类型的新要素。如果尚未指定有效配置，则将使用默认配置 ALL。 ALL —所有路径均有效。这是默认设置。 NONE —所有路径均无效。	String

派生输出

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

代码示例

AddTerminalConfiguration 示例 1（Python 窗口）

添加具有三个终端的双向终端配置。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')

AddTerminalConfiguration 示例 2（Python 窗口）

添加具有三个终端的定向终端配置。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')

AddTerminalConfiguration 示例 3（Python 窗口）

添加具有三个终端的定向终端配置。有效路径将使用终端对的集合进行指定。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

环境

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

许可信息

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