配置追踪

在追踪网络中进行追踪有助于随时解决问题并回答与网络状态有关的问题。 要追踪一个追踪网络,请使用追踪工具。

追踪工具提供了几种追踪类型

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

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

在结果中包括障碍

默认情况下,除非障碍要素与起点并存,否则将在跟追踪果中返回障碍要素。 这可使用包括障碍要素忽略起点的障碍选项进行控制。

包括障碍要素

在追踪结果中包括障碍。 这涵盖在追踪位置窗格中设置的要素障碍以及动态配置的障碍,包括:条件障碍、函数障碍、过滤器障碍和过滤器函数障碍。

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

配置选项描述

包括障碍要素

  • 选中 - 追踪结果将包括障碍要素。 这是默认设置。
  • 未选中 - 追踪结果将不包括障碍要素。

忽略起点处障碍

如果追踪配置中的障碍是起点,则将其忽略。

配置选项描述

忽略起点处障碍

  • 选中 - 追踪结果将忽略起点处的障碍。
  • 未选中 - 追踪结果将支持起点处的障碍。 这是默认设置。

确保网络一致性

网络的一致区域是指已验证网络拓扑且没有任何脏区的区域。 验证是保证追踪从网络拓扑读取有关您的网络的最新信息的唯一方法。

追踪工具中验证一致性配置选项可用于确保追踪结果与网络拓扑相一致。 当验证一致性设置为 true 时,如果任何脏区与追踪路径相交,则追踪操作将失败。 发生这种情况时,该工具将返回一个错误,其中包括被发现是脏区的追踪路径中的要素类名称和全局 ID,如以下示例所示:

ERROR 002041: One or more dirty areas were discovered.
[[NHDFlowline: {0DBFACDA-45D6-BA67-33CE-A750BE632C05}]]
Failed to execute (Trace).

要移除与编辑内容关联的脏区,必须验证网络拓扑。

注:

只有通过删除操作、对现有网络要素进行更新或创建错误要素时所创建的脏区才会造成有关追踪结果不一致的错误。 新创建要素的脏区不会造成验证一致性检测失败。

在未启用验证一致性复选框的情况下运行追踪可能导致意外的追踪结果。 例如,在一个网络中删除某一要素,破坏了位置 A 到位置 B 的唯一路径。 为被删除要素创建脏区。 在验证网络拓扑之前,必须执行追踪以寻找连接的要素(始于位置 A),不要选中验证一致性选项。 追踪到达位置 B,工具完成,没有出现警告。 到达位置 B,因为删除连接 A 和 B 的要素未通过执行验证操作在网络拓扑中进行更新。

如果在以上示例中选中验证一致性选项,当追踪到达标记删除要素的脏区时,工具将会返回错误,告知遇到脏区,同时追踪失败。 当被追踪区域已经验证了拓扑之后,则追踪无法到达位置 B,因为被删除要素已经反映到了网络拓扑中。 如果未针对要追踪区域的整个范围来验证网络拓扑,则还可能会遇到其他脏区。

配置选项描述

验证一致性

  • 选中 - 如果有任何脏区与追踪的要素相交,则工具会返回错误。 这是默认设置。
  • 未选中 - 脏区将被忽略。

控制追踪内容

在追踪过程中,可以使用障碍来表示停止位置;将不会追踪超出此位置范围的要素。 追踪结果将不包括超过障碍的要素,但可以选择性地包含障碍本身。 其他参数(例如允许不确定流向以及那些在高级选项中找到的参数)有助于定义控制网络路径可遍历性的因素。

允许不确定的流

在执行上溯或下溯追踪时,追踪分析将使用 Flow direction 网络属性中的值来确定方向性。 在某些情况下,可能会由指定了不确定流向的线要素表示双向流动。 此选项指定是沿路径追踪具有不确定流向的要素还是停止追踪的可遍历性。 此参数仅在运行上游追踪或下游追踪时使用。

配置选项描述

允许不确定的流

  • 选中 - 将追踪具有不确定流向的要素。
  • 未选中 - 具有不确定流向的要素将停止沿路径的可遍历性,并且不会被追踪。 这是默认设置。

高级选项

追踪工具的高级选项部分包括条件障碍函数障碍,用于控制追踪的可遍历性。 条件障碍指基于网络属性的表达式,用于定义追踪应停止的位置。 函数障碍用于定义满足条件时追踪的停止位置。

可遍历性范围由追踪工具中标记为应用可遍历性至traversability_scope 参数进一步控制。 此参数用于确定可遍历性是否应用于交汇点和/或边。 例如,如果可遍历性仅应用于交汇点,且边满足条件障碍中指定的条件,则根据可遍历性范围,追踪不会在边处停止。

有关详细信息,请参阅障碍

设置函数

函数作为追踪配置,可用于针对与被追踪的要素关联的网络属性运行计算。 可以向每个函数添加可选网络属性过滤器。 指定网络属性过滤器后,函数将仅应用于满足网络属性过滤器的要素。 函数中的过滤器可用来引入条件要求。 例如,可以将 PathType 属性包含值 Paved 的所有线的长度加起来。 可为追踪指定多个函数。

控制返回的内容

为控制追踪结果中返回的内容,提供了两个参数:输出条件结果类型

输出条件

输出条件过滤器支持使用网络属性并会筛选追踪过程中遇到的每个要素,以确定其是否满足过滤器中指定的条件。 网络属性存在于网络拓扑中,并与一个或多个要素类中的字段相关联。 在输出条件中,可以指定网络属性的名称、运算符以及网络属性的有效值。

请考虑一个涉及步道网络的情景,在这种情况下,将输入网络属性以返回已铺设步道。 在这种情况下,路径类具有名为 PathType 的字段。 该字段与名为 Surface 的网络属性相关联。 可配置输出条件参数以查找具有 Surface 网络属性且值为 Paved 的要素类。 追踪结果中包含具有此字段和 Paved 值的要素类中的要素,同时也包括不具有 PathType 字段的要素类中的要素。

通过使用组合使用参数,可以执行多个输出条件值。 可以使用两种类型的输出,并且可以设置多个输出类型。 组合多种输出类型可用于返回所有长度超过 1,000 米的已铺设步道。

结果类型

结果类型参数(可选)提供了用于控制追踪返回的结果类型的能力。 聚合几何选择网络图层结果类型可以分别或同时指定,以生成输出几何、生成选择集并将追踪结果作为选择集分别返回到组图层中的要素图层上。

参数选项

结果类型

  • 选择内容 - 追踪操作的结果将作为相应网络要素上的选择集返回。 这是默认设置。
  • 聚合几何 - 追踪操作的结果按几何类型聚合,并存储在活动地图的图层中显示的要素类中。
  • 网络图层 - 创建一个包含要素图层的组图层,该图层包含由追踪返回的一组要素选择。

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

查看下面的图像,以比较下溯追踪中选择内容和聚合几何结果类型选项之间的差异。 下面的网络包含五个线要素(表示为 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 和 f5::e1,e2)。 聚合几何结果将返回相同的三个要素,但不包括边元素 f1::e1 和 f5::e2。 如果我们通过取消选中包括障碍要素来排除障碍要素,则选择结果可能会更改;聚合几何结果将另外排除 f1::e2。

比较启用和禁用

当针对结果类型选择了聚合几何选项时,提供了四个附加参数来定义追踪输出行为。

  • 清除所有之前的追踪结果
  • 追踪名称
  • 聚合的点
  • 聚合的线

清除所有先前追踪结果复选框提供了一个选项,用于截断或附加到为存储聚合几何而选择的要素类的内容

参数选项

清除所有之前的追踪结果

  • 选中 - 将截断用于存储聚合追踪几何的要素类。 将仅写入当前追踪操作的输出几何。 这是默认设置。
  • 未选中 - 当前追踪操作的输出几何将追加到用于存储聚合几何的要素类。

追踪名称参数(可选)可用于为追踪操作创建字符串标识符,以帮助识别追踪结果。

聚合点聚合线参数可指定用于存储聚合结果几何的要素类。 默认情况下,将使用存储在工程默认地理数据库中的系统生成的要素类填充该参数。

  • Trace_Results_Aggregated_Lines - 线要素类
  • Trace_Results_Aggregated_Points - 多点要素类

如果这些要素类不存在,则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类,则该要素类必须包含一个名为 TRACENAME 字符串字段并与输出的几何类型相匹配。

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

注:

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

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

参数选项

选择内容类型

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

网络图层结果类型选项可以将追踪结果作为选择集返回到组图层中要素图层上。 当在 ArcGIS Pro 中选择此选项时,新的图层组将被添加到地图中。 仅为包含追踪返回的要素的类创建要素图层。 每个要素图层都包含由追踪返回的一组选择要素,这些要素可用于处理 ModelBuilderPython 中的追踪结果。

当选择了网络图层选项的时候,将提供附加输出组图层名称参数以命名创建的输出组图层。 在使用 ArcGIS Pro 时,新图层组将添加到具有特定名称的活动地图。

加载指定追踪配置

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

参数选项

使用追踪配置

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

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

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