追踪公共设施网络的目的是为随时发现并解决有关您网络状态的问题。 要追踪公共设施网络,请使用追踪工具。
除了这些追踪类型以外,追踪工具同时也包含一整套用于细化所提供的每种追踪类型的高级配置。 这些配置可用于建立可遍历性,区分应返回的要素或对象,以及设置要执行的计算。 ModelBuilder 可用于保存复杂的配置,并减少模型工具界面上显示的参数数量。 指定追踪配置可用于创建并存储可在整个组织共享的复杂追踪。 这样,您和其他用户仅需一键即可重新运行高级追踪。
在子网定义中设置子网追踪配置,可使追踪工具在对特定层执行追踪时实现自动填充。 此工具适用于基于子网的追踪。 例如,您希望子网追踪始终在保护设备处停止,以有效指示馈电线末端。 此外,您也始终希望计算每个馈电线的总负荷。 您可能不希望每次运行基于子网的追踪时都对这些参数进行设置,因此可以为层中的所有子网设置标准子网定义。 子网定义由管理员在创建层时(在将子网添加到该层之前)进行设置。 在追踪工具中指定层时,系统会自动填充高级参数,同时为输入层设置子网追踪定义。 执行追踪之前,可以在工具中手动覆盖填充的所有追踪配置参数。
在设置追踪期间,您可以对子网追踪定义进行修改或添加。 您可以进行如下操作:控制追踪的要素和对象类型(管道直径大于 6 英寸)、选择您想要返回的网络要素类型(所有打开的阀门),以及使用网络属性进行计算(计算 AB 相位线总长度)。
下面的部分将对各配置组件分别进行检查。 有关参数选项和使用方法信息,请参阅追踪工具。
异步运行追踪
从 ArcGIS Pro 2.9 和 ArcGIS Enterprise 10.9.1 开始,在服务器上以异步模式运行参数提供了使用 UtilityNetworkTools 地理处理服务异步处理进程追踪操作的选项。 此选项只有在公共设施网络为企业级地理数据库时可用。 默认情况下,系统将以同步方式处理追踪操作。
配置选项 | 描述 |
---|---|
在服务器上以异步模式运行 |
|
定义追踪区域
在追踪工具中,必须指定追踪在您的网络中允许行进的区域。 定义可追踪区域有助于确保追踪网络的预期部分。 也可将其用于限制某些追踪类型遍历到其他层。 三个信息片段将用于表示可追踪区域的范围:域网络、层和子网。 追踪类型决定了所需的信息片段,因此并非所有追踪都会具备这些参数。
指定域网络将限制为只追踪该域网络。 所有追踪都要求设置一个域网络。 一些追踪要求指定层,且在一些情况下会要求指定子网。 其他追踪类型要求设置层和目标层(上游和下游)。 目标层支持沿域网络中的多个层进行追踪。
通过在追踪工具中指定层参数,可以将追踪范围限制为特定层。 借助此参数,还可以使用为子网定义设置的值来自动填充追踪配置参数。 如果将起点与层参数结合使用,则起点必须位于指定层内。 目标层参数用于上溯和下溯追踪,表示可追踪网络的边界;追踪可在目标层中遍历,但不能超过目标层。
当跨多个层进行追踪时,将加载初始层的追踪配置设置。 对于追踪遇到的每个新层,将加载以下追踪配置设置:
- 可遍历性范围
- 条件障碍
- 函数障碍
- 传播程序
对于子网追踪,选择子网名称值可指定要追踪的子网,而不必使用起点。 由此使用子网控制器或指定子网的控制器作为追踪的起点。
在结果中包括容器、内容、结构和障碍
追踪工具中的可配置选项集可用于配置在结果中包含基于关联角色或障碍状态的网络要素。 关联要素可包括容器、内容和结构。 默认情况下,除了容器、容器中的内容和结构以外的其他内容都将返回到追踪的结果中。
包括容器
在追踪结果中包含容器。 追踪的所有内容要素和对象容器都将包括在追踪结果中。 此配置还可以用于追踪结构网络,例如,返回连接的地下管道。
配置选项 | 描述 |
---|---|
包括容器 |
|
最多包含第一个空间容器
指定是否将已返回的容器限制为仅在追踪结果中包含那些所遇到的容器,且最多包含每个网络元素的第一个空间容器。 如果没有遇到空间容器,但是给定网络元素存在非空间容器,则所有非空间容器都将包含在结果中。 此参数仅在已启用包括容器时可用。
配置选项 | 描述 |
---|---|
最多包含第一个空间容器 |
|
包括内容
在追踪结果中包括内容要素和对象。 这包括追踪结果中包含的容器中的内容。 要明确不同类型的容器,使用输出过滤器过滤结果。
配置选项 | 描述 |
---|---|
包括内容 |
|
包括结构
在追踪结果中包括结构。 这有助于报告结构资产之类的任务。
配置选项 | 描述 |
---|---|
包括结构 |
|
包括障碍要素
在追踪结果中包括障碍。 这涵盖在追踪位置窗格中设置的要素障碍以及动态配置的障碍,包括:条件障碍、函数障碍、过滤器障碍和过滤器函数障碍。 子网定义可用于配置障碍是否作为子网追踪配置的一部分包括在追踪结果中。
注:
如果将障碍放置在具有中跨连通性的边要素上并取消选中包括障碍要素选项,由追踪返回的选择集可能会显示意外结果。 如果追踪返回了要素的任何部分,则将选择整个要素并将其显示在追踪结果中。
配置选项 | 描述 |
---|---|
包括障碍要素 |
|
注:
包括障碍要素配置选项不适用于具备终端的要素。
忽略起点处障碍
如果追踪配置中的障碍是起点,则将其忽略。 这在执行上游保护设备追踪并使用所发现的保护设备(屏障)作为起始点以找到后续上游保护设备时可能非常有用。
配置选项 | 描述 |
---|---|
忽略起点处障碍 |
|
确保网络一致性
网络的一致区域不含任何脏区。 验证网络拓扑是保证追踪从网络拓扑读取有关您的网络的最新信息的唯一方法。 一些追踪类型要求您追踪的子网也为清洁子网。 有关详细信息,请参阅子网生命周期。
追踪工具中验证一致性选项可用于确保追踪结果与网络拓扑相一致。 当验证一致性设置为 true 时,如果任何脏区与追踪路径相交,则追踪操作将失败。 发生这种情况时,该工具将返回一个错误,其中包括被发现是脏区的追踪路径中任何要素或对象的类名称和全局 ID,如以下示例所示:
ERROR 002041: One or more dirty areas were discovered.
[[ElectricDistributionLine: {C0060506-AG17-4B64-B2E0-9162BE613C05}]]
Failed to execute (Trace).
以下情况不会导致追踪结果中产生有关不一致性的错误:
- 来自新创建的要素的脏区。
- 包括容器或包括结构选项未启用时的来自相关容器或结构的脏区。
要清理和移除脏区,请验证网络拓扑。
如果在未选中验证一致性复选框的情况下执行追踪,则可能导致非预期追踪结果;例如,在一个网络中删除某一要素,破坏了位置 A 到位置 B 的唯一路径。 为被删除要素创建脏区。 在验证网络拓扑之前,必须执行追踪以寻找连接的要素(始于位置 A),不要选中验证一致性选项。 追踪到达位置 B,工具完成,没有出现警告。 到达位置 B,因为未通过执行验证操作将删除连接 A 和 B 的要素反映到网络拓扑中。
如果在以上示例中选中验证一致性选项,当追踪到达标记删除要素的脏区时,追踪将失败,并会返回错误以告知您遇到脏区。 当被追踪区域已经验证了拓扑之后,则追踪无法到达位置 B,因为被删除要素已经反映到了网络拓扑中。 如果未针对要追踪区域的整个范围来验证网络拓扑,则可能会遇到其他脏区。
即使网络拓扑中的信息是可追踪区域的最新信息,子网也可能是脏子网。 请确保可追踪子网也进行了更新。 要了解详细信息,请参阅更新子网。
配置选项 | 描述 |
---|---|
验证一致性 | 选中此选项时,追踪将失败,并且工具会在有任何脏区与追踪路径相交时返回错误。 如果不选中此选项,则会忽略脏区。 此选项默认为选中。 |
确保非空间对象的可定位性
关联用于确定位置,并在视觉上表示在地图上非空间交汇点和边对象。 如果删除此关联,可能会导致交汇点或边对象无法定位的情况。 追踪中的验证可定位性选项和设置子网定义工具能够识别对象,而无需在遍历对象的关联层次结构中进行必要的包含、附加或连通性关联。
当验证可定位性设置为 true 时,如果在追踪路径中未发现不可定位对象,则追踪操作将失败并显示一条错误。 发生这种情况时,该工具将返回一个错误,其中包括追踪路径中的不可定位对象的类名称和全局 ID,如以下示例所示:
ERROR 003326: Unlocatable objects discovered.
[[GasDistributionJunctionObject: {4F860903-PK17-5c15-Y2W0-3512BP436C00}]]
Failed to execute (Trace).
修改关联窗格可用于为被视为可定位的对象创建必要的关联。
要了解详细信息,请参阅可定位性。
配置选项 | 描述 |
---|---|
验证可定位性 | 选中此选项时,追踪将失败,并且工具会在发现任何不可定位对象时返回错误。 如果未选中此选项,则不会对不可定位对象执行检查。 此选项默认为不选中。 |
控制追踪内容
在追踪过程中,可以使用障碍来表示停止位置;将不会追踪超出此位置范围的网络要素。 追踪结果不包括经过障碍的网络要素,但可选择包含障碍本身。 其他参数(例如允许不确定流向以及那些在可遍历性部分中找到的参数)有助于定义控制网络路径可遍历性的因素。
允许不确定的流
在执行上溯、下溯货分离追踪时,首先确定子网的流向,然后返回到起点的上溯或下溯的要素和对象。 在某些情况下,无法确定特定的流向,例如带有循环的方案。 在这种情况下,流程称为不确定的流。 默认情况下,当选中允许不确定流向参数时,追踪结果中将包括不确定流向的要素和对象。 如果未选中此选项,具有不确定流向的这些网络要素将停止可遍历性并且不会被包括在追踪结果中。 此参数仅在运行上溯追踪、下溯追踪或分离追踪时使用。
配置选项 | 描述 |
---|---|
允许不确定的流 |
|
可遍历性
追踪工具的可遍历性部分包括条件障碍和函数障碍,用于控制追踪的可遍历性。 条件障碍指基于网络属性或网络类别的表达式,用于定义追踪的停止位置。 函数屏障用于定义满足条件时追踪的停止时间。
可遍历性范围由追踪工具中标记为应用可遍历性至的 traversability_scope 参数进一步控制。 此参数用于确定可遍历性是否应用于交汇点和/或边。 例如,如果可遍历性仅应用于交汇点,且边满足条件障碍中指定的条件,则根据可遍历性范围,追踪不会在边处停止。
有关详细信息,请参阅障碍。
设置函数
函数是一种追踪配置属性,可用于在与被追踪网络要素相关联的网络属性上运行计算,例如,所有追踪的电线的总长度。 可为追踪指定多个函数。
另外,可选网络属性过滤器可添加到每个函数中;当被指定后,函数仅会被应用到满足网络属性过滤器的网络要素。 函数中的过滤器可用来引入条件要求,例如,可以将 Phases Current 属性包含值 A、B 和 C 的所有线的长度加起来。
注:
使用具有函数(Add、Average、Count、Max、Min 和 Subtract)的已分配网络属性的追踪配置可返回基于边元素的可分配结果。 例如,使用已连接追踪中的函数对 shape length 属性进行计数可返回基于各个边要素(而非整行)的计数。 有关详细信息,请参阅可分配网络属性。
控制返回的内容
要控制追踪结果中返回的内容,请使用输出过滤器。
输出过滤器
输出过滤器将筛选追踪过程中遇到的每个网络要素,以确定其是否满足过滤器中指定的条件。 例如,追踪将返回从电网起点开始的所有上游保护设备。
追踪工具中提供以下两种类型的输出过滤器:输出资产类型和输出条件。
输出资产类型过滤器用于仅包括追踪结果中指定的资产类型。 例如,电网的电线杆报告将包含输出资产类型过滤器,并会在结果中仅包含电线杆。
输出条件过滤器支持网络类别和网络属性。 例如,输出条件将使用特定网络类别名称来返回天然气网络中的所有隔离设备。 此操作将返回已分配隔离网络类别的所有要素和对象。 针对天然气网络的追踪可以返回应急阀、旁通阀、系统阀或短止回阀。 虽然也会追踪不属于此网络类别的要素和对象,但是不会将其包括在结果中。
网络属性存储在网络拓扑中,并与一个或多个网络类中的字段相关联。 在输出条件中,可以指定网络属性的名称、运算符以及对于网络属性有效的值。 如果供水管网中出现泄漏,则网络属性为用于返回可挤压管道的输入。 在这种情况下,线类具有名为 Pinchable 的字段。 该字段与名为 Pinchable 的网络属性相关联。 可将输出条件参数配置为查找具有 Pinchable 网络属性且值为 True 的类。 追踪结果中包含具有此字段且值为 True 的类中的要素和对象,同时也包括不具有 Pinchable 字段的类中的网络要素。
如果给定输出条件中网络属性的行为,要返回可挤压管道,则需要使用“输出资产类型”过滤器。 例如,在 Esri 提供的天然气公共设施网络中,可以在“分配管道”资产组中的 PipelineLine 类中指定塑料 PE 资产类型。 利用两个过滤器 IsPinchable = True AND AssetType = Plastic PE,追踪结果将仅包含塑料 PE 可挤压管道。
通过使用组合使用参数,可以执行多个输出条件值。 可以使用两种类型的输出,并且可以设置多个输出类型。 组合多种输出类型可用于返回所有超过 80 PSI 的 12 英寸塑料 PE 可挤压管道。
结果类型
通过结果类型参数(可选),您可以控制追踪返回的结果类型。
可以分别指定或同时指定聚合几何、选择、连通性、元素、要素以及包含和附件关联结果类型,从而相应地实现以下功能:生成输出几何,为追踪操作创建选择集,返回通过几何重叠或连通性关联连接的网络要素的连通图,返回要素相关信息,返回包含几何、网络属性和字段信息的要素相关信息,或者返回通过包含和结构附件关联连接至 .json 文件的要素。
参数 | 选项 |
---|---|
结果类型 |
注:使用企业级地理数据库时,必须满足以下要求:
|
聚合几何选项用于追踪可在要素类中作为多部分几何返回的结果。 此选项支持边要素的中跨上放置的起点和障碍的位置返回部分要素结果。
查看下面的图像,以比较下溯追踪中选择内容和聚合几何结果类型选项之间的差异。 下面的网络包含五个线要素(表示为 f1、f2、f3、f4 和 f5),而这些线要素由九个边元素(表示为 e1、e2、e3,以此类推)组成。
在此包含障碍要素的示例中,选择结果将返回由九个边元素组成的七个点要素和五个线要素(f1::e1,e2,e3、f2::e1,e2 和 f5::e1,e2)。 聚合几何结果将返回相同的要素,但不包括边元素 f1::e1,e2 和 f5::e2。
在选中包括障碍要素配置选项的情况下沿着边放置障碍时,追踪将在障碍要素处停止,并在追踪结果中返回边的部分要素几何。 如果未选中包括障碍要素选项,则追踪将在中跨连通性遇到的前一个线端点或交汇点处停止。
下例显示了使用包括障碍要素选项在追踪结果中包括或排除障碍要素的差异。 在此示例中,起点和障碍都沿着边放置。 启用此选项后,选择结果将返回由九个边元素组成的六个点要素和五个线要素(f1::e1,e2,e3、f2::e1,e2、f3::e1、f4::e1 和 f5::e1,e2)。 聚合几何结果将返回相同的五个要素,但不包括边元素 f1::e1 和 f5::e2。返回边元素 f1::e2 的部分几何。 如果您通过取消选中包括障碍要素来排除障碍要素,则选择结果可能会更改;聚合几何结果将另外排除 f1::e2。
当针对结果类型选择了聚合几何选项时,提供了五个附加参数来定义追踪输出行为。
- 清除所有之前的追踪结果
- 追踪名称
- 聚合的点
- 聚合的线
- 聚合的面
清除所有先前追踪结果复选框提供了一个选项,用于截断或附加到为存储聚合几何而选择的要素类的内容
参数 | 选项 |
---|---|
清除所有之前的追踪结果 |
|
追踪名称参数(可选)可用于为追踪操作创建字符串标识符,以帮助识别追踪结果。 如果使用时取消选中了清除所有之前的追踪结果参数复选框,则此参数允许运行多个追踪操作并比较输出聚合几何要素类中的结果。
聚合点、聚合线和聚合面参数可指定用于存储聚合结果几何的要素类。 默认情况下,将使用存储在工程默认地理数据库中的系统生成的要素类填充该参数。
- Trace_Results_Aggregated_Lines - 线要素类
- Trace_Results_Aggregated_Points - 多点要素类
- Trace_Results_Aggregated_Polygons - 面要素类
如果这些要素类不存在,则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类,则该要素类必须包含一个名为 TRACENAME 字符串字段并与输出的几何类型相匹配。
使用部分要素结果生成输出几何将提供更精确的追踪表示,并且可以比较和重用其他任务的追踪结果。
注:
如果聚合几何结果类型的输出要素类存在于工程的默认地理数据库中,则禁用地理处理选项允许地理处理工具覆盖现有数据集会导致工具验证问题。 可通过启用地理处理选项或在工程的默认地理数据库中重命名聚合的点、线和面要素类来解决此问题。
当针对结果类型选择了选择内容选项时,将提供另外一个选择类型参数,以定义将如何应用选择,以及在选择已经存在时将执行哪些操作。
参数 | 选项 |
---|---|
选择内容类型 |
|
连通性结果类型选项可将追踪结果作为通过几何重叠或连通性关联连接的网络要素的连通图返回。 选择此选项后,系统会将连通性信息输出到指定位置的 .json 文件中,可对该文件进行解析,并将其导入其他系统,以构建您自己的数据图形表示。 仅为追踪返回的网络要素返回连通性信息。 输出 .json 文件包含 connctivity 下所有遍历网络要素的以下信息:
- fromNetworkSourceId
- fromGlobalId
- fromObjectId
- fromTerminalId
- fromGeometry
- viaNetworkSourceId
- viaGlobalId
- viaObjectId
- viaPositionFrom
- viaPositionTo
- viaGeometry
- toNetworkSourceId
- toGlobalId
- toObjectId
- toTerminalId
- toGeometry
元素结果类型选项会将基于要素的信息返回到指定的输出 .json 文件中,该文件可用作执行其他分析的输入。 输出 .json 文件包含 elements 下所有遍历网络要素的以下信息:
- networkSourceId
- globalId
- objectId
- assetGroupCode
- assetTypeCode
对于点要素和交汇点对象,还会返回其他信息:
- terminalId
对于线要素和边对象,还会返回其他信息:
- positionFrom
- positionTo
要素结果类型选项会在指定的输出 .json 文件中将追踪结果以要素相关信息的形式返回。 与元素选项类似,您可通过此选项在输出中包含其他信息以用于其他应用程序,例如要素几何、网络属性相关信息以及属性字段值。 针对 featureElements 下所有已遍历的网络要素,输出 .json 文件包含的信息与上方元素选项返回的信息相同,还包含以下附加信息:
使用包括几何时返回的信息(不适用于交汇点和边对象):
- geometry
使用包括域描述时返回的信息:
- networkSourceName
- assetGroupName
- assetTypeName
- networkAttributeDescriptions(指定结果网络属性时)
对于点要素和交汇点对象,还会返回其他信息:
- terminalName
使用结果网络属性时返回的信息:
- networkAttributeValues
使用结果字段时返回的信息:
- fieldValues
包含和附件关联结果类型选项可针对具有包含和结构附件关联的已遍历网络要素在指定的输出 .json 文件中返回关联信息。 输出 .json 文件包含 associations 下所有遍历网络要素的以下信息:
- associationType
- fromNetworkSourceID
- fromGlobalId
- fromTerminalId
- toNetworkSourceID
- toGlobalId
- toTerminalId
使用包括域描述时返回的信息:
- fromNetworkSourceName
- fromTerminalName
- toNetworkSourceName
- toTerminalName
选择某些结果类型选项时,会启用一些附加参数:
- 选择连通性、元素、要素或包含和附件关联选项时,会提供附加的输出 JSON 参数以指示输出 .json 文件的位置。
- 选择要素或包含和附件关联选项时,会提供附加的包括域描述参数以包含所遍历网络要素的域描述。
- 选择要素选项时,会另提供包括几何、结果网络属性和结果字段参数,以输出所遍历网络要素的要素几何、网络属性信息和字段级信息。
使用按位运算符
追踪配置使用一组通用运算符定义追踪结果的障碍、过滤器、函数和输出。 标准运算符用于评估要素属性,可确定它们是否等于、小于或大于某个值。
追踪配置中使用的标准运算符包括等于、不等于、大于、大于等于、小于、小于等于。
按位运算符通过分析值的 bitset,在其逻辑中集成了位的使用。 这些运算符功能强大且灵活方便,常用于高级追踪应用程序。 追踪框架可以使用这些独立于用户定义的含义的位。
追踪配置中使用的按位运算符包括以下各项:
- Includes the values - 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
- Does not include the values - 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
- Includes any - 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
- Does not include any - 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。
对电力公共设施网络中的相位建模时,可以配置数据集以使用 bitset。 针对每个允许的相位组合和位表达(每个位具有一个含义)配置一组值。 将编码值属性域配置为可接受的相位值,并分配到使用相位的属性。 在相位字段中配置网络属性,以在追踪配置中使用。
下表概述了如何使用 bitset 对相位建模。 位置存储为编码,相位值用于编码值属性域中的描述。 表中的二进制列显示了每个 bitset 的二进制表示。 按位运算符可以解构属性,以评估每个部分,确定其是否符合运算逻辑。 如果网络属性为 AC (101) 且比较的值为 BC (011);“Includes the values”运算符的计算结果不会是 true,因为中间位 (B) 不在 AC 中,而使用“Includes any”运算符的计算结果将为 true,因为位 C 同时位于 AC 和 BC 中。
二进制 | 位值 | 相位值 |
---|---|---|
001 | 1 | C |
010 | 2 | B |
100 | 4 | A |
011 | 3 | BC |
101 | 5 | AC |
110 | 6 | AB |
111 | 7 | ABC |
例如,要找到子网中相位电流值中包括 A 的所有网络要素,则需要在配电域网络上执行子网追踪。 将在相位电流值为 A 的服务点上设置起点,并将以下追踪指定为过滤器障碍。 过滤器障碍配置为从追踪结果中排除不包括相位 A 的要素和对象。 要确保追踪结果中不包括障碍要素,请将包括障碍要素追踪配置选项设置为 false。 追踪结果中包括相位电流值为 A 或包括 A 的子网要素。Filter Barriers
Name: Phases Current
Operator: Does not include any (Bitwise AND equals False)
Type: Specific value
Value: 4 (code for A)
对追踪的网络要素执行计算
公共设施网络可提供名为属性传播的高级功能,以便在更新或追踪子网时使用。
可以通过为数据库字段配置网络属性来处理属性替换。 替换是一种网络属性类型,对于将属性替换类别分配给其资产类型的要素,其值用于计算该要素的传播值。 然后,可以使用生成的替换值来计算下一个连接的要素的值。 要使用属性替换,必须配置属性传播。
加载指定追踪配置
指定追踪配置允许创建复杂的追踪以进行共享和重用。 追踪工具使您可以加载现有的指定追踪配置,以定义追踪的属性。 这简化了与追踪相关的用户体验,并通过重用组织中的常见追踪来提供一致性。
参数 | 选项 |
---|---|
使用追踪配置 |
|
将提供指定将用于定义追踪属性的追踪配置的名称的追踪配置名称参数。 此参数仅在已启用使用追踪配置时可用。