配置追踪—ArcGIS Pro

追踪公共设施网络的目的是为随时发现并解决有关您网络状态的问题。要追踪公共设施网络，请使用追踪工具。

除了这些追踪类型以外，追踪工具同时也包含一整套用于细化所提供的每种追踪类型的高级配置。这些配置可用于建立可遍历性，区分应返回的要素，以及设置要执行的计算。ModelBuilder 可用于保存复杂的配置，还可用于减少模型工具界面上显示的参数数量。这样，您和其他用户仅需一键即可重新运行高级追踪。

例如，您的任务是制定一份报告，其内容是关于特定馈电线的、电压超过 60 伏的每台变压器所服务的客户数量。报告的内容应包含这些变压器的总负荷，并应标出哪些变压器所采用的是 25 年以上的木杆且最后一次检查的时间是 5 年前，以表明它们需要进行电杆检查。您将运行预配置的单一追踪，从而将上述信息全部返回给您。

在子网定义中设置子网追踪配置，可使追踪工具在对特定层执行追踪时实现自动填充。此工具适用于基于子网的追踪。例如，您希望子网追踪始终在保护设备处停止，以有效指示馈电线末端。此外，您也始终希望计算每个馈电线的总负荷。您可能不希望每次运行基于子网的追踪时都对这些参数进行设置，因此可以为层中的所有子网设置标准子网定义。子网定义由管理员在创建层时（在将子网添加到该层之前）进行设置。在追踪工具中指定层时，系统会自动填充高级参数，同时为输入层设置子网追踪定义。执行追踪之前，可以在工具中手动覆盖填充的所有追踪配置参数。

在设置追踪期间，您可以对子网追踪定义进行修改或添加。您可以进行如下操作：控制追踪的要素类型（管道直径大于 6 英寸）、选择您想要返回的要素类型（所有打开的阀门），以及使用网络属性进行计算（计算 AB 相位线总长度）。

下面的部分将对各配置组件分别进行检查。有关参数选项和使用方法信息，请参阅追踪工具。

定义追踪区域

在追踪工具中，必须指定追踪在您的网络中允许行进的区域。定义可追踪区域有助于确保追踪网络的预期部分。也可将其用于限制某些追踪类型遍历到其他层。三个信息片段将用于表示可追踪区域的范围：域网络、层和子网。追踪类型决定了所需的信息片段，因此并非所有追踪都会具备这些参数。

指定域网络将限制为只追踪该域网络。所有追踪都要求设置一个域网络。一些追踪要求指定层，且在一些情况下会要求指定子网。其他追踪类型要求设置层和目标层（上游和下游）。目标层支持沿域网络中的多个层进行追踪。

通过在追踪工具中指定层参数，可以将追踪范围限制为特定层。借助此参数，还可以使用为子网定义设置的值来自动填充追踪配置参数。如果将起点与层参数结合使用，则起点必须位于指定层内。目标层参数用于上溯和下溯追踪，表示可追踪网络的边界；追踪可在目标层中遍历，但不能超过目标层。

当跨多个层进行追踪时，将加载初始层的追踪配置设置。对于追踪遇到的每个新层，将加载以下追踪配置设置：

可遍历性范围
条件障碍
函数障碍
传播程序

对于子网追踪，选择子网名称值可指定要追踪的子网，而不必使用起点。由此使用子网控制器或指定子网的控制器作为追踪的起点。

在结果中包括容器、内容、结构和障碍

追踪工具中的可配置选项集可用于配置在结果中包含基于关联角色或障碍状态的要素。关联要素可包括容器、内容和结构。默认情况下，除了容器、容器中的内容和结构以外的其他内容都将返回到追踪的结果中。

包括容器

在追踪结果中包含容器。追踪的任何内容要素对应的容器要素都将包括在追踪结果中。此配置还可以用于追踪结构网络，例如，返回连接的地下管道。


配置选项	说明
包括容器	选中 - 追踪结果中将包含容器要素。未选中 - 追踪结果中将不包含容器要素。这是默认设置。

最多包含第一个空间容器

指定是否将已返回的容器限制为仅在追踪结果中包含那些所遇到的容器，且最多包含每个网络元素的第一个空间容器。如果没有遇到空间容器，但是给定网络元素存在非空间容器，则所有非空间容器都将包含在结果中。此参数仅在已启用包括容器时可用。


配置选项	说明
最多包含第一个空间容器	选中 - 当沿着追踪路径遇到嵌套的包含关联时，返回追踪结果中网络元素的所有容器，且最多包含第一个空间容器。如果空间容器不存在，则所有给定网络元素的非空间容器都将包含在结果中。未选中 - 所有容器都将返回到结果中。这是默认设置。

包括内容

在追踪结果中包括内容要素。这包括追踪结果中包含的容器中的内容。要对容器的不同类型消除歧义，可使用输出过滤器来过滤结果。


配置选项	说明
包括内容	选中 - 追踪结果将包含容器要素中的内容。未选中 - 追踪结果将不包含容器要素中的内容。这是默认设置。

包括结构

在追踪结果中包括结构。这有助于报告结构资产之类的任务。


配置选项	说明
包括结构	选中 - 追踪结果中将包含结构要素。未选中 - 追踪结果中将不包含结构要素。这是默认设置。

包括障碍要素

在追踪结果中包括障碍。这涵盖在追踪位置窗格中设置的要素障碍以及动态配置的障碍，包括：条件障碍、函数障碍、过滤器障碍和过滤器函数障碍。子网定义可用于配置障碍是否作为子网追踪配置的一部分包括在追踪结果中。

将障碍放置在具有中跨连通性的边要素上且已禁用包括障碍要素选项时，由追踪返回的选择集可能会显示意外结果。如果追踪返回了要素的任何部分，则将选择整个要素并将其显示在追踪结果中。


配置选项	说明
包括障碍要素	选中 - 追踪结果中将包含障碍要素。这是默认设置。未选中 - 追踪结果中将不包含障碍要素。注：此追踪配置选项也受基于子网的追踪类型的子网追踪配置影响。将在指定层参数时加载此选项。

注：

包括障碍要素配置选项不适用于具备终端的要素。

忽略起点处障碍

如果追踪配置中的障碍是起点，则将其忽略。这在执行上游保护设备追踪并使用所发现的保护设备（屏障）作为起始点以找到后续上游保护设备时可能非常有用。


配置选项	说明
忽略起点处障碍	选中 - 追踪过程中将忽略起点处的障碍。未选中 - 追踪过程中不会忽略起点处的障碍。这是默认设置。

确保网络一致性

网络一致区域不包含任何脏区，且网络拓扑已被验证。这是保证追踪从网络拓扑读取有关您的网络的最新信息的唯一方法。一些追踪类型要求您追踪的子网也为清洁子网。要了解详细信息，请参阅脏子网。

追踪工具中验证一致性选项可用于确保追踪结果与网络拓扑相一致。当验证一致性设置为 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 可挤压管道。

了解有关使用多条件表达式的详细信息

结果类型

结果类型参数（可选）提供了用于控制追踪返回的结果类型的能力。要生成输出几何以及为追踪操作设置的选择内容，可以独立或同时指定聚合几何和选择内容结果类型。


参数	选项
结果类型	选择内容 - 追踪操作的结果将作为相应网络要素上的选择集返回。这是默认设置。聚合几何 - 追踪操作的结果按几何类型聚合，并存储在活动地图的图层中显示的多部分要素类中。

聚合几何选项用于追踪可在要素类中作为多部分几何返回的结果。此选项支持边要素的中跨上放置的起点和障碍的位置返回部分要素结果。

查看下面的图像，以比较下溯追踪中选择内容和聚合几何结果类型选项之间的差异。下面的网络包含五个线要素（表示为 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 字符串字段并与输出的几何类型相匹配。

使用部分要素结果生成输出几何将提供更精确的追踪表示，并且可以比较和重用其他任务的追踪结果。

注：

如果工程的默认地理数据库中存在聚合的几何结果类型的输出要素类，则禁用地理处理选项允许地理处理工具覆盖现有数据集可能导致工具验证问题。要解决此问题，可通过启用地理处理选项或重命名工程默认地理数据库中的聚合的点、线和面要素类。

当针对结果类型选择了选择内容选项时，将提供另外一个选择类型参数，以定义将如何应用选择，以及在选择已经存在时将执行哪些操作。


参数	选项
选择内容类型	新建选择内容 - 生成的选择内容将替换当前选择内容。这是默认设置。添加到当前选择内容 - 当存在一个选择内容时，会将生成的选择内容添加到当前选择内容中。如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。从当前选择内容中移除 - 结果选择内容将从当前选择内容中删除。如果不存在选择内容，该选项不起作用。选择当前选择内容的子集 - 结果选择内容与当前选择内容将会合并在一起。只有两者共同的记录才会被选取。切换当前选择内容 - 将会切换结果选择内容。将所选的结果从当前选择内容中移除，同时将未选取的结果添加到当前选择内容中。如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。

使用按位运算符

追踪配置使用一组通用运算符定义追踪结果的障碍、过滤器、函数和输出。标准运算符用于评估要素属性，可查看它们是否等于、小于或大于某个值。

追踪配置中使用的标准运算符包括等于、不等于、大于、大于等于、小于、小于等于。

按位运算符通过分析值的 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)

对追踪的网络要素执行计算

公共设施网络可提供名为属性传播的高级功能，以便在更新、导出或追踪子网时使用。

替换是一种网络属性。对于将属性替换类别分配给其资产类型的要素，它是用于计算该要素的传播值的值。然后，可以使用生成的替换值来计算下一个连接的要素的值。要使用属性替换，必须配置传播。

有关详细信息，请参阅属性传播程序和属性替换。

负载追踪配置

追踪配置允许创建复杂的追踪以进行共享和重用。追踪工具使您可以加载现有的追踪配置，以定义追踪的属性。这简化了与追踪相关的用户体验，并通过重用组织中的常见追踪来提供一致性。


参数	选项
使用追踪配置	选中 - 此工具将使用现有追踪配置来定义追踪的属性。选中后，仅显示追踪配置名称、起点、障碍参数。加载使用聚合的几何结果类型选项的追踪配置时，聚合的点、聚合的线和聚合的面参数也会一并显示。未选中 - 此工具将不使用追踪配置来定义追踪的属性。这是默认设置。

将提供指定将用于定义追踪属性的追踪配置的名称的追踪配置名称参数。此参数仅在已启用使用追踪配置时可用。

了解有关追踪配置的详细信息

有关此主题的反馈?