追踪 (追踪网络工具)

汇总

可根据指定起点的连通性或可遍历性返回追踪网络中的所选要素。

追踪网络的追踪功能用于分析网络中的路径。 可遍历性指通过已连接同时满足配置要求的要素建立的路径。

默认情况下，追踪结果将作为选择返回，并包含整个线要素。 要返回部分要素结果，可将结果类型 参数设置为聚合几何。 当将起点或障碍放置在具有中跨连通性的交汇点上时，追踪结果将返回边要素的部分元素。 当障碍沿边放置时，追踪结果可以在具有中跨连通性的最近交汇点处停止。 然后，可以将追踪生成的结果选择集或输出要素类传播到另一个地图、传递到网络的逻辑示意图，或者将其用作另一个工具或追踪的输入。

了解有关追踪追踪网络的详细信息

用法

• 必须启用 网络拓扑。

• 在使用企业级地理数据库时，输入追踪网络必须来自要素服务；不支持来自数据库连接的追踪网络。

• 由于追踪工具依赖于网络拓扑，如果追踪范围内存在脏区，则无法保证追踪结果准确。 待追踪区域的网络拓扑必须经过验证，才能反映对网络进行的最近编辑或更新。

• 对于条件障碍、函数障碍、函数和输出条件，当使用分配给日期字段的网络属性时，日期值应采用格式 yyyy-mm-dd hh:mm:ss，例如，2020-10-12 18:45:31。

参数

• Dialog
• Python

标注	说明	数据类型
输入追踪网络	将运行追踪的追踪网络。 在使用企业级地理数据库时，输入追踪网络必须来自要素服务；不支持来自数据库连接的追踪网络。	Trace Network; Trace Network Layer
追踪类型	指定要执行的追踪类型。 已连接—将使用从一个或多个起点开始并沿着已连接要素向外跨越的已连接追踪。 上游—将使用能够发现网络中某位置上游的要素的上游追踪。 这种类型的追踪需要设置流向。 下游—将使用能够发现网络中某位置下游的要素的下游追踪。 这种类型的追踪需要设置流向。 最短路径—将使用可查找网络中两个起点之间的最短路径（不考虑流向）的最短路径追踪。 遍历路径的成本取决于为最短路径网络属性名称参数设置的网络属性。 已连接—将使用从一个或多个起点开始并沿着已连接要素向外跨越的已连接追踪。 上游—将使用能够发现网络中某位置上游的要素的上溯追踪。 这种类型的追踪需要设置流向。 下游—将使用能够发现网络中某位置下游的要素的下溯追踪。 这种类型的追踪需要设置流向。 最短路径—将使用可查找网络中两个起点之间的最短路径（不考虑流向）的最短路径追踪。 遍历路径的成本取决于为 shortest_path_network_attribute_name 参数设置的网络属性。	String
起点	使用追踪位置窗格中的起点选项卡创建的要素图层，或包含一个或多个表示追踪起点的记录的表或要素类。 在使用追踪位置窗格中的起点工具创建起点时，默认情况下，将使用 TN_Temp_Starting_Points 要素类，并在工程的默认地理数据库中生成该要素类。	Feature Layer; Table View
障碍 （可选）	包含一个或多个要素，表示防止追踪遍历超出此点的追踪障碍的表或要素类。 在使用追踪位置窗格中的障碍选项卡创建障碍时，默认情况下，将使用 TN_Temp_Barriers 要素类，并在工程的默认地理数据库中生成该要素类。	Feature Layer; Table View
路径方向 （可选）	指定追踪路径的方向。 遍历路径的成本取决于最短路径网络属性名称参数值。 仅当运行最短路径追踪类型时，才会使用此参数。 无方向—将使用两个起点之间的路径（无论流向为何）。 这是默认设置。 上游路径—将使用两个起点之间的上游路径。 下游路径—将使用两个起点之间的下游路径。	String
最短路径网络属性名称 （可选）	用于计算路径的网络属性的名称。 运行最短路径追踪类型时，使用数字网络属性（例如形状长度）计算最短路径。 基于成本和距离的路径都可以进行计算。 运行最短路径追踪时，需要此参数。	String
包括障碍要素 （可选）	指定追踪结果中是否包含可遍历性障碍要素。 选中—追踪结果中将包含可遍历性障碍要素。 这是默认设置。 未选中—追踪结果中将不包含可遍历性障碍要素。	Boolean
验证一致性 （可选）	指定如果在任何遍历的要素中遇到脏区是否返回错误。 这是保证追踪通过网络中状态一致要素的唯一方法。 要移除脏区，请验证网络拓扑。 选中—如果在任何遍历的要素中遇到脏区，追踪将返回错误。 这是默认设置。 未选中—无论是否在遍历的要素中遇到脏区，追踪都将返回结果。	Boolean
忽略起点处障碍 （可选）	指定是否在追踪配置中忽略起点处的障碍。 选中—追踪过程中将忽略起点处的障碍。 未选中—追踪过程中不会忽略起点处的障碍。 这是默认设置。	Boolean
允许不确定的流 （可选）	指定是否追踪具有不确定或未初始化流向的要素。 此参数仅在运行上游追踪或下游追踪时使用。 选中—将追踪具有不确定流向或未初始化流向的要素。 未选中—不会追踪具有不确定流向或未初始化流向的要素。 这是默认设置。	Boolean
条件障碍 （可选）	基于与网络属性的比较，对要素设置可遍历性障碍条件。 条件障碍使用网络属性、运算符和类型以及属性值。 例如，当要素的 Code 属性等于 ArtificialPath 这一特定值时，将停止追踪。 当要素满足此条件时，追踪将停止。 如果您要使用多个属性，可使用组合方法参数来定义 And 或 Or 条件。 值表列： Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Type—Filter by a specific type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	Value Table
函数障碍 （可选）	基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。 例如，所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时，追踪将停止。 值表列： Function—Filter by a function. Min—The minimum of the input values. Max—The maximum of the input values. Average—The average of the input values. Count—The number of features. Add—Add the values. Subtract—Subtract the values. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	Value Table
应用可遍历性至 （可选）	指定将应用的可遍历性类型。 可遍历性范围用于确定是否在交汇点和/或边处应用可遍历性。 例如，在游憩步道网络中，如果条件障碍定义为当 SurfaceType 属性包含值“gravel”并且可遍历性范围设置为仅交汇点时停止追踪，则即使遇到 Surfacetype 字段具有此值的边要素，追踪也不会停止，因为 Surfacetype 属性仅适用于边。 交汇点和边—可遍历性将同时应用于交汇点和边。 这是默认设置。 仅交汇点—可遍历性将仅应用于交汇点。 仅边—可遍历性将仅应用于边。	String
函数 （可选）	将应用于追踪结果的计算函数。 值表列： Function—Filter by a function. Min—The minimum of the input values. Max—The maximum of the input values. Average—The average of the input values. Count—The number of features. Add—The sum of the values. Subtract—The difference between the values. Attribute—Filter by a network attribute Filter Name—Filter by attribute name. Filter Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Filter Type—Filter by attribute type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Filter Value—Filter by a specific value. Function Name—The name for the alias to describe the function result.	Value Table
输出条件 （可选）	根据网络属性返回的要素类型。 例如，如果将追踪配置为“过滤掉除水龙头要素外的所有要素”，那么未分配“水龙头”属性的追踪要素均不会包含在结果中。 任何追踪的要素都会返回到结果选择集中。 值表列： Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Type—Filter by a specific type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Combine multiple conditions. And—Combine the conditions. Or—Use if either condition is met.	Value Table
结果类型 （可选）	指定追踪返回的结果的类型。 选择—追踪结果将作为相应网络要素上的选择集返回。 这是默认设置。 聚合几何—追踪结果按几何类型聚合，并存储在活动地图的图层中显示的要素类中。 网络图层—追踪结果将被作为图层组内的选择集添加到要素图层。 连通性—追踪结果将作为指定输出 .json 文件中的连通图返回。 此选项将启用输出 JSON 参数。 元素—追踪结果将作为指定输出 .json 文件中的基于要素的信息返回。 此选项将启用输出 JSON 参数。	String
选择内容类型	指定如何应用所选内容以及如果已存在当前内容要执行的操作。 新建选择内容—生成的选择内容将替换当前选择内容。 这是默认设置。 添加到当前选择内容—当存在一个选择内容时，会将生成的选择内容添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。 从当前选择内容中移除—将生成的选择内容从当前选择内容中移除。 如果不存在选择内容，该选项不起作用。 选择当前选择内容的子集—将生成的选择内容与当前选择内容进行组合。 仅两者共有的记录保持选中状态。 切换当前选择内容—生成的选择内容将被切换。 将所选的结果从当前选择内容中移除，同时将未选取的结果添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。	String
清除所有之前的追踪结果 （可选）	指定将内容从选定用来存储聚合几何的要素类中截断，还是追加到该要素类中。 此参数仅适用于聚合几何结果类型。 选中—将截断用于存储聚合追踪几何的要素类。 将仅写入当前追踪操作的输出几何。 这是默认设置。 未选中—当前追踪操作的输出几何将追加到用于存储聚合几何的要素类。	Boolean
追踪名称 （可选）	追踪操作的名称。 此值将存储在输出要素类的 TRACENAME 字段中，以协助识别追踪结果。 此参数仅适用于聚合几何结果类型。	String
聚合的点 （可选）	包含聚合结果几何的输出多点要素类。 默认情况下，将使用名为 Trace_Results_Aggregated_Points 的系统生成要素类填充该参数，该要素类将存储在工程的默认地理数据库中。 如果该要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须是多点要素类，并且包含名为 TRACENAME 的字符串字段。 此参数仅适用于聚合几何结果类型。	Feature Class
聚合的线 （可选）	包含聚合结果几何的输出折线要素类。 默认情况下，将使用名为 Trace_Results_Aggregated_Lines 的系统生成要素类填充该参数，该要素类将存储在工程的默认地理数据库中。 如果该要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须是折线要素类，并且包含名为 TRACENAME 的字符串字段。 此参数仅适用于聚合几何结果类型。	Feature Class
输出图层组名称 （可选）	输出图层组的名称，其中包含具有由追踪返回的要素选择集的要素图层。 该图层将提供在 ModelBuilder 和 Python 中使用追踪输出的访问权限。 此参数仅适用于网络图层结果类型。	Group Layer
使用追踪配置 （可选）	指定是否将使用现有指定追踪配置来填充追踪工具的参数。 注: 此参数需要追踪网络版本 2 或更高版本。 选中—将使用现有指定追踪配置来定义追踪的属性。 将忽略除追踪配置名称、起点和障碍之外的所有参数。 未选中—不使用现有指定追踪配置来定义追踪的属性。 这是默认设置。	Boolean
追踪配置名称 （可选）	将用于定义追踪属性的追踪配置的名称。 仅当选中使用追踪配置参数时，才启用此参数。 注: 此参数需要追踪网络版本 2 或更高版本。	String
输出 JSON （可选）	将生成的 .json 文件的名称和位置。	File

派生输出

标注	说明	数据类型
已更新的追踪网络	更新的追踪网络。	Any Value

环境

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

许可信息

• 基本: 受限
  在使用 ArcGIS Enterprise 授权用户许可时，支持企业部署。
• 标准: 是
• 高级: 是

相关主题

• 追踪网络工具箱概述
• 查找地理处理工具