添加规则 (公共设施网络)

描述

用于向公共设施网络中添加规则。

创建于公共设施网络中的所有规则均基于资产组和资产类型级别的网络类，并且可以用于控制公共设施网络中的一些行为。

使用方法

• 必须禁用网络拓扑。

• 使用企业级地理数据库时，必须满足以下要求：
  • 输入公共设施网络参数值必须来自作为数据库公共设施网络所有者建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者。

语法

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})

参数	说明	数据类型
in_utility_network	将添加规则的公共设施网络。	Utility Network; Utility Network Layer
rule_type	要创建的规则类型。 JUNCTION_JUNCTION_CONNECTIVITY —创建交汇点-交汇点连通性关联规则，允许两点通过连通性进行连接（要素会发生几何偏移）。 CONTAINMENT —创建包含规则，其中“自”参数为容器，“至”参数为包含关联中的内容。 STRUCTURAL_ATTACHMENT —创建结构附件规则，其中“自”参数为结构要素，“至”参数为结构附件关联中的附件要素。 JUNCTION_EDGE_CONNECTIVITY —创建边-交汇点规则，允许边和交汇点要素通过几何重叠进行连接（要素位于相同的 x,y,z 位置）。 EDGE_JUNCTION_EDGE_CONNECTIVITY —创建边-交汇点-边连通性规则，允许边连接到交汇点要素的任一侧。	String
from_class	将包括在规则中的“自”公共设施网络要素类或表。 结构附件和包含关联规则要求容器或结构要素在此参数中。 交汇点-交汇点、交汇点-边和边-交汇点-边连通性规则的顺序不重要。	String
from_assetgroup	要应用规则的 from_class 的资产组。	String
from_assettype	要应用规则的 from_class 的资产类型。	String
to_class	将包括在规则中的“至”公共设施网络要素类或表。 结构附件和包含关联规则要求内容或附件要素在此参数中。 交汇点-交汇点、交汇点-边和边-交汇点-边连通性规则的顺序不重要。	String
to_assetgroup	要应用规则的 to_class 的资产组。	String
to_assettype	指定要应用规则的 to_class 的资产类型。	String
from_terminal （可选）	要应用规则的“自”终端。该终端为 from_class 中的终端。为具有终端的要素创建连通性规则以连接到另一个要素时，必须指定连接自的终端侧，例如变压器上的高压侧终端。 如果资产类型包括终端，则此参数为必填项。如果为结构附件或包含规则类型，则将忽略此参数。	String
to_terminal （可选）	要应用规则的“至”终端。该终端为 to_class 中的终端。为要素创建连通性规则以连接到另一个要素时，必须指定连接到的终端侧，例如变压器上的高压侧终端。 如果资产类型包括终端，则此参数为必填项。如果为结构附件或包含规则类型，则将忽略此参数。	String
via_class （可选）	要应用规则的交汇点公共设施网络要素类或表。仅可为 EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type 指定该参数，因为需要三个要素类参与边-交汇点-边连通性。	String
via_assetgroup （可选）	要应用规则的 via_class 的资产组。仅可为 EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type 参数值指定该参数。	String
via_assettype （可选）	要应用规则的 via_class 的资产类型。仅可为 EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type 参数值指定该参数。	String
via_terminal （可选）	要应用规则的 via_class 的终端。仅可为 EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type 参数值指定该参数。	String

派生输出

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

代码示例

AddRule 示例 1（Python 窗口）

在此示例中，创建了交汇点-交汇点连通性规则，可使断路器负载侧连接到配电网中变压器的高压侧。

import arcpy
arcpy.AddRule_un("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")

AddRule 示例 2（Python 窗口）

在此示例中，创建了交汇点-边连通性规则，可使断路器负载侧连接到配电网中的中压线。

import arcpy
arcpy.AddRule_un("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")

AddRule 示例 3（Python 窗口）

此示例脚本创建了包含关联规则，可使交汇点框中包含弯头。

import arcpy
arcpy.AddRule_un("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")

AddRule 示例 4（Python 窗口）

此示例脚本创建了结构附件关联规则，可将开关附加到电线杆结构中。

import arcpy
arcpy.AddRule_un("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

环境

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

许可信息

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