子网追踪配置

子网追踪配置可指定子网中所更新导出追踪的要素和对象。 子网追踪配置是子网定义的可选组件。

子网追踪配置需使用设置子网定义工具进行设置。 此工具用于定义子网追踪配置以表示层中子网的标准定义。 例如,在配电网络中:虽然从断路器直至维修点之间存在连通性,但是您仍然希望在分隔电路的开关处终止对单个子网的追踪。 子网追踪配置可以整合这些设置。

设置子网定义工具选项用于根据期关联角色或障碍状态来控制结果中包括的网络要素。 关联可用于包含容器、内容和结构,以及检查非空间物体是否可定位。 默认情况下,为子网定义启用包含容器包含内容包含结构,并在更新、导出或追踪子网时包含在内。 默认禁用验证可定位性

可以使用 AND 和 OR 布尔运算符在单个参数中创建组合语句。 例如,您有三个条件,并且您希望查找满足条件 1 和 2 或者条件 1 和 3 的要素。 您可以创建使用 OR 或 AND 连接的 4 个条件,例如,在打开的活动要素处停止追踪,或停止追踪活动的保护设备。

针对层设置的子网追踪配置用于向更新子网导出子网追踪工具提供信息。 可以通过手动调整工具上的参数或以编程方式进行调整来覆盖存储在标准定义中的某些信息。 例如,您可能希望了解是否可对开启的阀门进行不同组合,从而为居民区提供足够的压力。 针对工具的运行对追踪配置进行修改后,将不会修改正在追踪的层的子网定义。

注:

使用具有函数(Add、Average、Count、Max、Min 和 Subtract)的已分配网络属性的追踪配置可返回基于边元素的可分配结果。 例如,使用已连接追踪中的函数对 shape length 属性进行计数可返回基于各个边要素(而非整行)的计数。 有关详细信息,请参阅可分配网络属性

配置选项包括:

  • 包含容器 - 指定是否包含容器。
  • 包含内容 - 指定是否包含容器的内容。
  • 包含结构 - 指定是否包含结构。
  • 包含障碍要素 - 指定是否包含障碍。
  • 验证可定位性 - 指定遇到无法定位的交汇点或边对象时是否返回错误。
  • 汇总 - 计算有关子网的函数信息,并将其存储在 SubnetLine 要素类中。
  • 条件障碍 - 定义将基于网络属性和类别停止操作的要素或对象。
  • 函数障碍 - 定义将基于函数停止操作的要素或对象。
  • 应用可遍历性至 - 定义要实施的可遍历范围。 将可遍历性仅应用于交汇点,仅应用于边,或者同时应用于交汇点和边。
  • 传播程序 - 使用传播的网络属性来控制所考虑的网络要素。 Substitution 函数可用。 只能通过 Python 使用此参数。

汇总

子网追踪配置可选组件的汇总可用于收集有关子网的附加信息,并将其存储在 SubnetLine 要素类的属性中。 例如,可以使用天然气网络中的汇总来传达最大允许操作压力 (MAOP) 并输出压力区的客户服务总数。

作为子网络追踪配置的一部分,可以使用设置子网定义工具,为该层子网络定义中定义的所有有效要素和非空间对象配置汇总。 配置包括设置函数、指定网络属性以及指定来自用于存储结果的 SubnetLine 要素类的属性。 或者,您可以设置过滤器,以限制将在汇总计算中使用的要素。

以下矩阵列出了有效的字段类型,可基于指定的函数和网络属性字段类型来定义摘要属性字段。 例如,要创建用于报告来自长整型网络属性类型的平均值的摘要,可以在 SubnetLine 要素类上创建一个双精度类型的字段,并将其指定为摘要属性字段:

网络属性类型矩阵
此为基于指定函数的汇总属性字段的有效字段类型矩阵。

如果不存在用于存储汇总结果的字段,可以使用添加字段工具来添加一个字段。 一个字段仅可支持一个汇总结果;因此每个汇总都需要在 SubnetLine 要素类中具有自己的字段。

唯一使用汇总的工具是更新子网工具。 更新子网时,该操作会将汇总结果写入汇总属性的 SubnetLine 要素类中。

存在摘要时,即使没有将 SubnetLine 要素类的聚合线参数指定为层的子网定义的一部分,也会在类中创建一条记录以显示子网和摘要信息。 此操作会创建一条具有空几何的记录,当您在使用非空间网络要素或多个 SubnetLine 要素重叠的情况下想要汇总子网信息时可能有用,可在降低几何效用的同时仍支持访问摘要信息。

使用过滤器汇总示例

以下是用于设置汇总属性的配置参数示例,该汇总属性将在更新子网时进行填充。 可在设置子网定义工具子网追踪配置部分中的汇总下执行此操作:

下表显示了用于在工具的子网追踪配置部分中创建汇总的参数。 有关此追踪配置组件所需参数的详细信息,请参阅设置子网定义工具的汇总参数。

在本示例中,对于电网中的中压层,请将 SUBNETWORKLENGTH 的汇总属性配置为包括所有中压线的总长度。 Shape_Length 网络属性的总和需通过 Add 函数进行计算,该函数仅适用于网络中的中压线。 要在子网中只应用中压线的函数,则将使用系统提供的网络属性 Asset group 作为过滤器名称文本,同时将过滤器类型设置为 SPECIFIC_VALUE,将过滤器值设置为 5(中压的编码值)。

参数

函数

属性

形状长度

过滤器名称

资产组

过滤运算符

IS_EQUAL_TO

过滤器类型

SPECIFIC_VALUE

过滤值

5

汇总属性

SUBNETWORKLENGTH

子网追踪配置部分中汇总的参数和示例值。

障碍

公共设施网络还可以基于条件和函数对要素动态设置障碍。 可遍历性障碍可被限制为只应用于点、只应用于线,或同时应用于点和线。

条件障碍使用网络属性、运算符和类型以及属性值。 例如,您可以设置一个条件障碍,该条件障碍可以继续导出要素,直到满足以下条件:Device Status equal to Type 'Open',其中 Device Status 是网络属性,equal to 是运算符,Type 是特定值,Open 是属性值。

函数障碍会使用函数、网络属性、运算符以及值。 函数障碍可用于限制追踪距离起点的行程或设置停止追踪的最大压力值。 所经过的每条线的长度或压力都被添加到目前经过的总值中。 当经过的总长度达到指定值时(例如 5 + 10 + 20 + 5 + 10 = 50),追踪将停止。

包括障碍要素选项适用于所有障碍类型,并可将其配置为子网定义的一部分或在追踪工具中进行手动设置。

传播程序和替换

传播程序可计算控制器下游要素的网络属性值。 例如,在电网中,如果相 A 在上游断电,则即使要素的网络属性可能指示相 A,传播程序也会算出下游要素的相位值将使相 A 断电。

传播过程中可能会使用替换;它们可将每一位网络属性值映射或转换为另一位网络属性值。 例如,如果替换将位 A 映射到位 B,并且在传播过程中发现值为 AC 的网络属性,由于替换定义了从 A 到 B 的映射,因此值 AC 将视为 BC。

传播程序和替换均在子网定义阶段进行定义,并在追踪操作、子网更新或子网导出期间使用。

有关详细信息,请参阅使用属性传播使用属性替换

工具应用

更新子网导出子网追踪工具使用除汇总之外的上述所有组件。 运行时,仅更新子网工具使用汇总。

当使用 PythonArcGIS Pro SDK 运行更新子网导出子网工具时,可以对子网追踪配置进行修改。 追踪工具可用于修改工具界面上除传播程序和替换以外的任何组件。 要访问追踪工具中的传播程序,您必须使用 Python模型构建器ArcGIS Pro SDK

通过 Python 使用追踪工具运行基于子网的追踪时,不会自动应用输入层的子网追踪配置,必须手动进行指定。