描述
用于向现有公共设施网络添加终端配置。
带有终端的要素需要约束来定义设备或交汇点对象的内部连通性的有效配置。此工具可用于向公共设施网络添加新的终端配置,稍后可以使用设置终端配置工具将其分配给资产组或资产类型级别的类。
使用方法
通过分配终端配置,可以在设备或交汇点对象上配置终端。只能向支持终端的各个资产类型分配一个终端配置。
要素上的终端具有方向性设置。终端可以设置为定向(仅允许一个流动方向)或双向(允许两个流向)。
最少必须指定 2 个终端,最多可以指定 8 个终端。终端名称应该是有意义的描述,例如高压侧或源端。
对于具有三个或四个终端的要素,可以定义有效配置。该操作用于处理复杂的开关设备,您需要在这些开关设备中限制终端对之间的流动路径。例如,在终端名称为 A、B、C 和 D 的四终端设备中,您可能希望允许从 A 流向 B 和 C,但不允许从 A 流到 D。
必须禁用网络拓扑。
使用企业级地理数据库时,需要满足以下要求:
- 当连接到默认版本时,必须执行此工具。
- 输入公共设施网络参数必须来自作为数据库公共设施网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者。
语法
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 | 指定终端配置的方向性。定向可遍历性模型意味着终端的流动仅有一个方向。双向可遍历性模型意味着终端允许双向流动。
| String |
terminals_directional [[name, upstream],...] (可选) | 每个终端的名称和方向流。最少必须指定 2 个终端,最多可以指定 8 个终端。每个终端的名称不能超过 32 个字符。如果 traversability_model 参数值为 DIRECTIONAL,则此参数为必需项。
| Value Table |
terminals_bidirectional [[name],...] (可选) | 每个双向终端的名称。最少必须指定 2 个终端,最多可以指定 8 个终端。每个终端的名称不能超过 32 个字符。如果方向性参数值为双向(在 Python 中为 traversability_model = "BIDIRECTIONAL"),则此参数为必需项。 | Value Table |
valid_paths [[Name, [Value]],...] (可选) | 终端配置的有效路径的名称。对于双向可遍历性,如果存在三个或更多终端,则需要此参数。如果使用定向可遍历性,则其中一个终端必须为上游,才能具有有效配置。必须设置有效路径才能指示设备或交汇点对象内要遍历的资源的有效路径。为每个有效路径提供名称并指定值。
| Value Table |
default_path (可选) | 有效配置的默认路径。该路径将分配至将此终端配置分配至其资产类型的新要素。如果尚未指定有效配置,则将使用默认配置 ALL。
| String |
派生输出
名称 | 说明 | 数据类型 |
out_utility_network | 更新的公共设施网络。 | 公共设施网络 |
代码示例
添加具有三个终端的双向终端配置。
import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1',
'BIDIRECTIONAL', 'A;B;C',
'Top A-B;Bottom A-C', 'Top')
添加具有三个终端的定向终端配置。
import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2',
'DIRECTIONAL', 'A true;B true;C false',
'Top A-B;Bottom A-C', 'Bottom')
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是