添加追踪配置 (公共设施网络)

在 Standard 或 Advanced 许可等级下可用。

摘要

在公共设施网络中创建指定追踪配置。

指定追踪配置用于配置和存储复杂追踪的属性,以供重用和共享。 在公共设施网络中创建的指定追踪配置可以在 ArcGIS Pro 中与追踪工具配合使用,或者通过追踪窗格中的指定配置选项卡来使用指定追踪配置。 在企业部署中工作时,这些也可以通过 web 地图进行共享并由 web 和外业应用程序使用。

了解有关如何创建指定追踪配置的详细信息

使用情况

  • 输入公共设施网络参数值必须是版本 5 或更高版本。

  • 使用企业级地理数据库时,输入公用设施网络必须来自公共设施网络服务。

  • 连接的门户账户将设置为指定追踪配置的创建者。 操作系统身份验证用于在单用户部署中使用公共设施网络时存储指定追踪配置的创建者。

  • 许可:
    活动门户账户必须被分配 ArcGIS Advanced Editing 用户类型扩展模块,才能在企业级部署中使用此工具。

参数

标注说明数据类型
输入公共设施网络

包含新的指定追踪配置的公共设施网络。

Utility Network; Utility Network Layer
追踪配置名称

指定追踪配置的名称。

String
追踪类型

指定要配置的追踪类型。

  • 在线将使用从一个或多个起点开始并沿着已连接要素向外跨越的已连接追踪。 这是默认设置。
  • 子网将使用子网追踪,其从一个或多个起点开始向外跨越,目的是涵盖子网的范围。
  • 子网控制器将使用能够定位与子网关联的子网控制器上的源和汇的子网控制器追踪
  • 上游将使用能够发现网络中某位置上游的要素的上溯追踪
  • 下游将使用能够发现网络中某位置下游的要素的下溯追踪
  • 循环将使用能够从基于连通性的起点向外跨越的循环追踪。 循环是流向不明确的网络区域。
  • 最短路径将使用能够识别两个起点之间的最短路径的最短路径追踪
  • 孤立将使用能够发现孤立网络区域的要素的孤立追踪
String
描述
(可选)

指定追踪配置的描述。

String
标签
(可选)

用于标识指定追踪配置的标签集。 可在搜索和索引中使用此类标签。

String
域网络
(可选)

将运行追踪的域网络的名称。 运行子网、子网控制器、上溯和下溯追踪类型时,需要此参数。

String
(可选)

追踪将开始的层的名称。 运行子网、子网控制器、上溯和下溯追踪类型时,需要此参数。

String
目标层
(可选)

输入层将流向的目标层的名称。 如果未指定上溯和下溯追踪中的此参数,当到达起始子网边界时,上述追踪将停止。 该参数可以使此类追踪在层级结构中继续向上或向下延伸。

String
子网名称
(可选)

将运行追踪的子网的名称。 运行子网追踪类型时可以使用此参数。 如果指定了子网名称,则不需要起点。 当子网表包含层级的 10,000 条或更多记录时,不会填充参数的选择列表,并且会为子网名称提供一个空字段。

String
最短路径网络属性名称
(可选)

将用于计算最短路径的网络属性。 运行最短路径追踪类型时,使用数字网络属性(例如形状长度)计算最短路径。 基于成本和距离的路径都可以进行计算。 运行最短路径追踪时,需要此参数。

String
包括容器
(可选)

指定追踪结果中是否包含容器要素。

  • 选中 - 追踪结果中将包含容器要素。 最多包含第一个空间容器参数将变为活动状态。
  • 未选中 - 追踪结果中将不包含容器要素。 这是默认设置。

Boolean
包括内容
(可选)

指定追踪是否将在结果中返回容器要素的内容。

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

Boolean
包括结构
(可选)

指定追踪结果中是否包含结构要素和对象。

  • 选中 - 追踪结果中将包含结构要素和对象。
  • 未选中 - 追踪结果中将不包含结构要素和对象。 这是默认设置。

Boolean
包括障碍要素
(可选)

指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设,可遍历性障碍仍可选。 此参数不适用于具备终端的设备要素。

  • 选中 - 追踪结果中将包含可遍历性障碍要素。 这是默认设置。
  • 未选中 - 追踪结果中将不包含可遍历性障碍要素。

Boolean
验证一致性
(可选)

指定如果在任何遍历的要素中遇到脏区是否返回错误。 这是保证追踪通过网络中状态一致要素的唯一方法。 要移除脏区,请验证网络拓扑。

  • 选中 - 如果在任何遍历的要素中遇到脏区,追踪将返回错误。 这是默认设置。
  • 未选中 - 无论是否在遍历的要素中遇到脏区,追踪都将返回结果。

Boolean
条件障碍
(可选)

基于与网络属性的比较或对类别字符串的检查,对要素设置可遍历性障碍条件。 条件障碍根据网络属性或类别、操作符、类型及属性值来定义。 例如,当要素的 Device Status 属性等于 Open 的特定值时,将停止追踪。 当要素满足此条件时,追踪将停止。 如果您要使用多个属性,可使用组合方法参数来定义 And 或 Or 条件。

条件障碍组件如下:

  • 名称 - 可按系统中定义的任意网络属性进行过滤,或选择 Category 作为网络类别。
  • 运算符 - 从大量运算符中进行选择。
  • 类型 - 选择名称参数的值类型 Specific valueNetwork attribute,以此作为障碍。 当名称参数为 Category 时,必须将类型参数设置为 Specific value
  • - 提供会基于运算符值导致终止的输入属性或类别的特定值。
  • 组合方法 - 如果要添加多个条件,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

条件障碍运算符值选项如下:

  • Is equal to - 该属性等于该值。
  • Does not equal - 该属性不等于该值。
  • Is greater than - 该属性大于该值。
  • Is greater than or equal to - 该属性大于或等于该值。
  • Is less than - 该属性小于该值。
  • Is less than or equal to - 该属性小于或等于该值。
  • Includes the values - 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • Does not include the values - 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • Includes any - 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • Does not include any - 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

条件障碍类型值选项如下:

  • 特定值 - 按特定值过滤。
  • 网络属性 - 按网络属性过滤。

Value Table
函数障碍
(可选)

基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作:限制追踪距离起点的行程或设置停止追踪的最大值。 例如,所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时,追踪将停止。

函数障碍组件如下:

  • 函数 - 从大量计算函数中进行选择。
  • 属性 - 按系统中定义的任何网络属性进行过滤。
  • 运算符 - 从大量运算符中进行选择。
  • - 提供将导致终止的输入属性类型(若发现)的特定值。
  • 使用局部值 - 计算每个方向的值,而不是整体全局值,例如计算 Shape length 总和的函数障碍,其中,如果值大于或等于 4,则追踪终止。 在全局情况下,遍历两条值为 2 的边之后,Shape length 总和即已达到 4,因此追踪会停止。 如果使用本地值,每条路径上的本地值会变化,且追踪将继续。
    • 选中 - 将使用局部值。
    • 未选中 - 将使用全局值。 这是默认设置。

函数障碍函数值选项如下:

  • Minimum - 输入值的最小值。
  • Maximum - 输入值的最大值。
  • Add - 输入值的总和。
  • Average - 输入值的平均值。
  • Count - 要素数目。
  • Subtract - 输入值之间的差值。

    子网控制器和循环追踪类型不支持减函数。

例如,起点要素的值为 20。 下一个要素的值为 30。 如果使用 Minimum 函数,则结果为 20;使用 Maximum 函数,结果为 30;使用 Add 函数,结果为 50;使用 Average 函数,结果为 25;使用 Count 函数,结果为 2;使用 Subtract 函数,结果为 -10。

函数障碍运算符值选项如下:

  • Is equal to - 该属性等于该值。
  • Does not equal - 该属性不等于该值。
  • Is greater than - 该属性大于该值。
  • Is greater than or equal to - 该属性大于或等于该值。
  • Is less than - 该属性小于该值。
  • Is less than or equal to - 该属性小于或等于该值。
  • Includes the values - 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • Does not include the values - 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • Includes any - 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • Does not include any - 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

Value Table
应用可遍历性至
(可选)

指定可遍历性是否应用于交汇点和/或边。 例如,如果定义了用于停止追踪的条件障碍,其中 Device Status 等于 Open 并将遍历范围仅设置为边,则即使追踪遇到开路设备,追踪也不会停止,因为 Device Status 仅适用于交汇点。 换言之,此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • 交汇点和边可遍历性将同时应用于交汇点和边。 这是默认设置。
  • 仅交汇点可遍历性将仅应用于交汇点。
  • 仅边可遍历性将仅应用于边。
String
过滤器障碍
(可选)

用于指定针对特定类别或网络属性的追踪停止时间。 例如,针对生命周期状态属性等于特定值的要素,追踪停止。 此参数用于根据系统中定义的网络属性值设置终止符。 如果要使用多个属性,可使用组合方法选项来定义 And 或 Or 条件。

过滤器障碍组件如下:

  • 名称 - 按类别或系统中定义的任何网络属性进行过滤。
  • 运算符 - 从大量运算符中进行选择。
  • 类型 - 从名称参数中指定的值中选择特定值或网络属性。
  • - 提供会基于运算符值导致终止的输入属性类型的特定值。
  • 组合方法 - 如果要添加多个属性,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

过滤器障碍运算符值选项如下:

  • Is equal to - 该属性等于该值。
  • Does not equal - 该属性不等于该值。
  • Is greater than - 该属性大于该值。
  • Is greater than or equal to - 该属性大于或等于该值。
  • Is less than - 该属性小于该值。
  • Is less than or equal to - 该属性小于或等于该值。
  • Includes the values - 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • Does not include the values - 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • Includes any - 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • Does not include any - 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

过滤器障碍类型值选项如下:

  • 特定值 - 按特定值过滤。
  • 网络属性 - 按网络属性过滤。

Value Table
过滤器函数障碍
(可选)

用于过滤特定类别的追踪结果。

过滤器函数障碍组件如下:

  • 函数 - 从大量计算函数中进行选择。
  • 属性 - 按系统中定义的任何网络属性进行过滤。
  • 运算符 - 从大量运算符中进行选择。
  • - 提供将导致终止的输入属性类型(若发现)的特定值。
  • 使用局部值 - 计算每个方向的值,而不是整体全局值。 例如计算形状长度总和的函数障碍,其中,如果值大于或等于 4,则追踪终止。 在全局情况下,遍历两条值为 2 的边之后,形状长度总和即已达到 4,因此追踪会停止。 如果使用本地值,每条路径上的本地值会变化,否则追踪将继续。
    • 选中 - 将使用局部值。
    • 未选中 - 将使用全局值。 这是默认设置。

过滤器函数障碍函数值选项如下:

  • 最小值 - 将识别输入值的最小值。
  • 最大值 - 将识别输入值的最大值。
  • 相加 - 将计算各值的总和。
  • 平均 - 将计算输入值的平均值。
  • 计数 - 将识别要素数。
  • - 将计算各值之间的差值。 子网控制器和循环追踪类型不支持减函数。

例如,起点要素的值为 20。 下一个要素的值为 30。 如果使用 Minimum 函数,则结果为 20。 使用 Maximum 函数,结果为 30;使用 Add 函数,结果为 50;使用 Average 函数,结果为 25;使用 Count 函数,结果为 2;使用 Subtract 函数,结果为 -10。

过滤器函数障碍运算符值选项如下:

  • 等于 - 该属性等于该值。
  • 不等于 - 该属性不等于该值。
  • 大于 - 该属性大于该值。
  • 大于或等于 - 该属性大于或等于该值。
  • 小于 - 该属性小于该值。
  • 小于或等于 - 该属性小于或等于该值。
  • Includes the values - 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • Does not include the values - 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • Includes any - 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • Does not include any - 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

Value Table
将过滤器应用于
(可选)

指定是否在交汇点、边或这两处应用特定类别的过滤器。 例如,如果定义了用于停止追踪的过滤器障碍,其中 Device Status 等于 Open 并将遍历范围仅设置为边,则即使追踪遇到开路设备,追踪也不会停止,因为 Device Status 仅适用于交汇点。 换言之,此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • 交汇点和边 - 过滤器将同时应用于交汇点和边。 这是默认设置。
  • 仅交汇点 - 过滤器将仅应用于交汇点。
  • 仅边 - 过滤器将仅应用于边。

String
按 bitset 网络属性过滤
(可选)

将用于按 bitset 过滤的网络属性的名称。 此参数仅适用于上溯、下溯和循环追踪类型。 此参数可用于在追踪过程中添加特殊逻辑,以便追踪能够更好地反映真实世界的场景。 例如,对于循环追踪而言,Phases current 网络属性可以确定该循环是否为实际的电气循环(相同的相在循环 A 中各处均有电流通过),并且追踪结果只返回实际的电气循环。 上溯追踪的示例如下;如果追踪配电网络时指定 Phases current 网络属性,则追踪结果将只包含在网络属性中指定的有效路径,而不是所有路径。

String
按最近过滤
(可选)

指定是否使用 k-最近邻算法在给定距离内返回一些特定类型的要素。 可以提供计数、成本以及类别和/或资产类型的集合。

  • 选中 - 将使用 k-最近邻算法来返回计数成本网络属性最近类别最近资产组/类型参数中指定的一定数量的要素。
  • 未选中 - k 最近邻算法不会用于过滤结果。 这是默认设置。

Boolean
计数
(可选)

按最近过滤为选中状态时要返回的要素数量。

Long
成本网络属性
(可选)

按最近过滤为选中状态时,将用于计算接近度、成本或距离的数字网络属性(例如形状长度)。

String
最近类别
(可选)

按最近过滤处于选中状态时,将返回的类别(例如保护类别)。

String
最近资产组/类型
(可选)

按最近过滤处于选中状态时,将返回的资产组和资产类型(例如,ElectricDistributionDevice/Transformer/Step Down)。

String
函数
(可选)

将应用于追踪结果的计算函数。

函数组件如下:

  • 函数 - 从大量计算函数中进行选择。
  • 属性 - 按系统中定义的任何网络属性进行过滤。
  • 过滤器名称 - 按属性名称过滤函数结果。
  • 过滤器运算符 - 从大量运算符中进行选择。
  • 过滤器类型 - 从大量过滤类型中进行选择。
  • 过滤器值 - 提供输入过滤属性的特定值。

函数 Function 值选项如下:

  • 平均 - 将计算输入值的平均值。
  • 计数 - 将识别要素数。
  • 最大值 - 将识别输入值的最大值。
  • 最小值 - 将识别输入值的最小值。
  • 相加 - 将计算输入值的总和。
  • 相减 - 将计算输入值之间的差值。

    子网控制器和循环追踪类型不支持减函数。

例如,起点要素的值为 20。 下一个要素的值为 30。 如果使用 Minimum 函数,则结果为 20;使用 Maximum 函数,结果为 30;使用 Add 函数,结果为 50;使用 Average 函数,结果为 25;使用 Count 函数,结果为 2;使用 Subtract 函数,结果为 -10。

函数过滤器运算符值选项如下:

  • 等于 - 该属性等于该值。
  • 不等于 - 该属性不等于该值。
  • 大于 - 该属性大于该值。
  • 大于或等于 - 该属性大于或等于该值。
  • 小于 - 该属性小于该值。
  • 小于或等于 - 该属性小于或等于该值。
  • 包括值(按位与等于值)- 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • 不包括值(按位与不等于值)- 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • 包括任何值(按位与等于 True)- 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • 不包括任何值(按位与等于 False)- 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

函数过滤器类型值选项如下:

  • 特定值 - 按特定值过滤。
  • 网络属性 - 按网络属性过滤。

  • 平均值将计算输入值的平均值。
  • 计数将识别要素数量。
  • 最大值将识别输入值的最大值。
  • 最小值将识别输入值的最小值。
  • 将计算输入值的总和。
  • 将计算输入值之间的差值。子网控制器和循环追踪类型不支持减函数。
Value Table
传播程序
(可选)
  • 等于属性与值相等。
  • 不等于属性与值不相等。
  • 大于属性大于值。
  • 大于或等于属性大于或等于值。
  • 小于属性小于值。
  • 小于或等于属性小于或等于值。
  • 包括值(按位与等于值)值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • 不包括值(按位与不等于值)并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • 包括任何值(按位与等于 True)值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • 不包括任何值(按位与等于 False)值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。
Value Table
输出资产类型
(可选)

过滤要包含在结果中的输出资产类型 - 例如,仅返回架空变压器。

String
输出条件
(可选)

按网络属性或类别返回的要素类型。 例如,如果将追踪配置为“过滤掉除水龙头要素外的所有要素”,那么未分配水龙头类别的追踪要素均不会包含在结果中。 任何追踪的要素都会返回到结果选择集中。

输出条件组件如下:

  • 名称 - 按系统中定义的任何网络属性进行过滤。
  • 运算符 - 从大量运算符中进行选择。
  • 类型 - 从名称参数中指定的值中选择特定值或网络属性。
  • - 提供会基于运算符值导致终止的输入属性类型的特定值。
  • 组合方法 - 如果要添加多个属性,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

输出条件运算符值选项如下:

  • 等于 - 该属性等于该值。
  • 不等于 - 该属性不等于该值。
  • 大于 - 该属性大于该值。
  • 大于或等于 - 该属性大于或等于该值。
  • 小于 - 该属性小于该值。
  • 小于或等于 - 该属性小于或等于该值。
  • 包括值(按位与等于值)- 值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • 不包括值(按位与不等于值)- 值中的所有位并非都存在于属性中的“按位与”运算(按位与 != 值)。
  • 包括任何值(按位与等于 True)- 值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • 不包括任何值(按位与等于 False)- 值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

输出条件类型值选项如下:

  • 特定值 - 按特定值过滤。
  • 网络属性 - 按网络属性过滤。

Value Table
包括孤立要素
(可选)

指定追踪结果中是否包含孤立要素。 此参数仅在运行孤立追踪时使用。

  • 选中 - 追踪结果中将包含孤立要素。
  • 未选中 - 追踪结果中将不包含孤立要素。 这是默认设置。

注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 10.7 或更高版本。

Boolean
忽略起点处障碍
(可选)

指定是否在追踪配置中忽略起点处的动态障碍。 这在执行上游保护设备追踪并使用所发现的保护设备(屏障)作为起始点以找到后续上游保护设备时可能非常有用。

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

Boolean
最多包含第一个空间容器
(可选)

指定返回的容器是否仅限于追踪结果中每个网络元素的第一个空间容器(包括第一个空间容器)。 如果没有遇到空间容器,但是存在给定网络元素的非空间容器,则所有非空间容器都将包含在结果中。 仅当选中包含容器时,此参数才处于活动状态。

  • 选中 - 当沿追踪路径遇到嵌套包含关联时,结果中仅返回遇到次数最多并包括第一个空间容器的容器。 如果不存在空间容器,则给定网络元素的所有非空间容器都将包含在结果中。
  • 未选中 - 所有容器都将在结果中返回。 这是默认设置。
Boolean
结果类型
(可选)

指定追踪返回的结果的类型。

  • 选择追踪结果将作为相应网络要素上的选择集返回。 这是默认设置。
  • 聚合几何追踪结果按几何类型聚合,并存储在活动地图的图层中显示的多部件要素类中。
String
允许不确定的流
(可选)

指定是否追踪具有不确定流向的要素。 仅在运行上溯追踪、下溯追踪或孤立追踪时应用此参数。

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

Boolean
验证可定位性
(可选)

指定当遇到非空间交汇点或边对象在遍历要素的关联层次结构中没有关联的容器或结构时,是否返回错误。 此参数可确保追踪返回的非空间对象与空间要素关联。

  • 选中 - 当遇到非空间交汇点或边对象在遍历要素的关联层次结构中没有关联的容器或结构时,追踪将返回错误。
  • 未选中 - 追踪不会检查是否存在无法定位的对象并返回结果,无论遍历要素的关联层次结构中是否存在无法定位的对象。 这是默认设置。

Boolean
使用数字化方向
(可选)

指定上游和下游追踪操作是否将使用线的数字化方向、关联中边缘对象的“起始”和“终止”全局 ID 以及 Flow direction 属性来确定流向。 当追踪类型参数设置为上游下游时,此参数仅适用于 Utility Network 版本 7 及更高版本。

  • 选中 - 追踪操作将使用线的数字化方向、关联中边对象的“起始”和“结束”全局 ID 以及流向属性来确定流向。 选中此项后,域网络目标层参数将被隐藏并忽略。
  • 未选中 - 跟踪操作将根据子网控制器的位置确定流向。 这是默认设置。

注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 11.3 或更高版本。

Boolean
合成几何
(可选)

指定是否为作为跟踪操作的一部分遍历的关联和边缘对象推断和创建(合成)几何。 此参数仅适用于聚合几何结果类型。

  • 选中 - 将为输出 Trace_Results_Aggreerated_Lines 要素类中遍历的关联和边对象推断并创建几何。
  • 未选中 - 不会为遍历的关联和边对象合成几何。 这是默认设置。

注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 11.3 或更高版本。

Boolean

派生输出

标注说明数据类型
输出公共设施网络

更新的公共设施网络。

Utility Network

arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, {allow_indeterminate_flow}, {validate_locatability}, {use_digitized_direction}, {synthesize_geometries})
名称说明数据类型
in_utility_network

包含新的指定追踪配置的公共设施网络。

Utility Network; Utility Network Layer
trace_config_name

指定追踪配置的名称。

String
trace_type

指定要配置的追踪类型。

  • CONNECTED将使用从一个或多个起点开始并沿着已连接要素向外跨越的已连接追踪。 这是默认设置。
  • SUBNETWORK将使用子网追踪,其从一个或多个起点开始向外跨越,目的是涵盖子网的范围。
  • SUBNETWORK_CONTROLLERS将使用能够定位与子网关联的子网控制器上的源和汇的子网控制器追踪
  • UPSTREAM将使用能够发现网络中某位置上游的要素的上溯追踪
  • DOWNSTREAM将使用能够发现网络中某位置下游的要素的下溯追踪
  • LOOPS将使用能够从基于连通性的起点向外跨越的循环追踪。 循环是流向不明确的网络区域。
  • SHORTEST_PATH将使用能够识别两个起点之间的最短路径的最短路径追踪
  • ISOLATION将使用能够发现孤立网络区域的要素的孤立追踪
String
description
(可选)

指定追踪配置的描述。

String
tags
[tags,...]
(可选)

用于标识指定追踪配置的标签集。 可在搜索和索引中使用此类标签。

String
domain_network
(可选)

将运行追踪的域网络的名称。 运行子网、子网控制器、上溯和下溯追踪类型时,需要此参数。

String
tier
(可选)

追踪将开始的层的名称。 运行子网、子网控制器、上溯和下溯追踪类型时,需要此参数。

String
target_tier
(可选)

输入层将流向的目标层的名称。 如果未指定上溯和下溯追踪中的此参数,当到达起始子网边界时,上述追踪将停止。 该参数可以使此类追踪在层级结构中继续向上或向下延伸。

String
subnetwork_name
(可选)

将运行追踪的子网的名称。 运行子网追踪类型时可以使用此参数。 如果指定了子网名称,则不需要 starting_points 参数。

String
shortest_path_network_attribute_name
(可选)

将用于计算最短路径的网络属性。 运行最短路径追踪类型时,使用数字网络属性(例如形状长度)计算最短路径。 基于成本和距离的路径都可以进行计算。 运行最短路径追踪时,需要此参数。

String
include_containers
(可选)

指定追踪结果中是否包含容器要素。

  • INCLUDE_CONTAINERS追踪结果中将包含容器要素。
  • EXCLUDE_CONTAINERS追踪结果中将不包含容器要素。 这是默认设置。
Boolean
include_content
(可选)

指定追踪是否将在结果中返回容器要素的内容。

  • INCLUDE_CONTENT追踪结果将包含容器要素中的内容。
  • EXCLUDE_CONTENT追踪结果将不包含容器要素中的内容。 这是默认设置。
Boolean
include_structures
(可选)

指定追踪结果中是否包含结构要素和对象。

  • INCLUDE_STRUCTURES追踪结果中将包含结构要素和对象。
  • EXCLUDE_STRUCTURES追踪结果中将不包含结构要素和对象。 这是默认设置。
Boolean
include_barriers
(可选)

指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设,可遍历性障碍仍可选。 此参数不适用于具备终端的设备要素。

  • INCLUDE_BARRIERS追踪结果中将包含可遍历性障碍要素。 这是默认设置。
  • EXCLUDE_BARRIERS追踪结果中将不包含可遍历性障碍要素。
Boolean
validate_consistency
(可选)

指定如果在任何遍历的要素中遇到脏区是否返回错误。 这是保证追踪通过网络中状态一致要素的唯一方法。 要移除脏区,请验证网络拓扑。

  • VALIDATE_CONSISTENCY如果在任何遍历的要素中遇到脏区,追踪将返回错误。 这是默认设置。
  • DO_NOT_VALIDATE_CONSISTENCY无论是否在遍历的要素中遇到脏区,追踪都将返回结果。
Boolean
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(可选)

基于与网络属性的比较或对类别字符串的检查,对要素设置可遍历性障碍条件。 条件障碍根据网络属性或类别、操作符、类型及属性值来定义。 例如,当要素的 Device Status 属性等于 Open 的特定值时,将停止追踪。 当要素满足此条件时,追踪将停止。 如果您要使用多个属性,可使用组合方法参数来定义 And 或 Or 条件。

条件障碍组件如下:

  • Name - 按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量运算符中进行选择。
  • Type - 从 name 参数指定的值中选择特定值或网络属性。
  • Value - 提供会基于运算符值导致终止的输入属性类型的特定值。
  • Combine Using - 如果要添加多个属性,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

条件障碍 operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

条件障碍 Type 值选项如下:

  • SPECIFIC_VALUE按特定值过滤。
  • NETWORK_ATTRIBUTE按网络属性过滤。

条件障碍 Combine Using 值选项如下:

  • AND合并条件障碍。
  • OR满足任一条件障碍时使用。

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

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(可选)

基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作:限制追踪距离起点的行程或设置停止追踪的最大值。 例如,所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时,追踪将停止。

函数障碍组件如下:

  • Function - 从大量计算函数中进行选择。
  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量运算符中进行选择。
  • Value - 提供将导致终止的输入属性类型(若发现)的特定值。
  • Use Local Values - 计算每个方向的值,而不是整体全局值。 例如计算形状长度总和的函数障碍,其中,如果值大于或等于 4,则追踪终止。 在全局情况下,遍历两条值为 2 的边之后,形状长度总和即已达到 4,因此追踪会停止。 如果使用本地值,每条路径上的本地值会变化,且追踪将继续。

函数障碍 Function 值选项如下:

  • AVERAGE将计算输入值的平均值。
  • COUNT将识别要素数量。
  • MAX将识别输入值的最大值。
  • MIN将识别输入值的最小值。
  • ADD将计算输入值的总和。
  • SUBTRACT将计算输入值之间的差值。 子网控制器和循环追踪类型不支持减函数。

函数障碍 operator 值选项如下:

  • IS_EQUAL_TO函数结果等于该值。
  • DOES_NOT_EQUAL函数结果不等于该值。
  • IS_GREATER_THAN函数结果大于该值。
  • IS_GREATER_THAN_OR_EQUAL_TO函数结果大于或等于该值。
  • IS_LESS_THAN函数结果小于该值。
  • IS_LESS_THAN_OR_EQUAL_TO函数结果小于或等于该值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

函数障碍 Use Local Values 选项如下:

  • TRUE将使用局部值。
  • FALSE将使用全局值。 这是默认设置。
Value Table
traversability_scope
(可选)

指定可遍历性是否应用于交汇点和/或边。 例如,如果定义了用于停止追踪的条件障碍,其中 Device Status 等于 Open 并将遍历范围仅设置为边,则即使追踪遇到开路设备,追踪也不会停止,因为 Device Status 仅适用于交汇点。 换言之,此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • BOTH_JUNCTIONS_AND_EDGES可遍历性将同时应用于交汇点和边。 这是默认设置。
  • JUNCTIONS_ONLY可遍历性将仅应用于交汇点。
  • EDGES_ONLY可遍历性将仅应用于边。
String
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(可选)

用于指定针对特定类别或网络属性的追踪停止时间。 例如,针对生命周期状态属性等于特定值的要素,追踪停止。 此参数用于根据系统中定义的网络属性值设置终止符。 如果要使用多个属性,可使用 Combine Using 选项来定义 And 或 Or 条件。

过滤器障碍组件如下:

  • Name - 按类别或系统中定义的任何网络属性进行过滤。
  • Operator - 从大量运算符中进行选择。
  • Type - 从 name 参数指定的值中选择特定值或网络属性。
  • Value - 提供会基于运算符值导致终止的输入属性类型的特定值。
  • Combine Using - 如果要添加多个属性,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

过滤器障碍 Operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INLCUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

过滤器障碍 Type 值选项如下:

  • SPECIFIC_VALUE按特定值过滤。
  • NETWORK_ATTRIBUTE按网络属性过滤。

过滤器障碍 Combine Using 值选项如下:

  • AND合并条件障碍。
  • OR满足任一条件障碍时使用。

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

Value Table
filter_function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(可选)

用于过滤特定类别的追踪结果。

过滤器函数障碍组件如下:

  • Function - 从大量计算函数中进行选择。
  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量运算符中进行选择。
  • Value - 提供将导致终止的输入属性类型(若发现)的特定值。
  • Use Local Values - 计算每个方向的值,而不是整体全局值。 例如计算形状长度总和的函数障碍,其中,如果值大于或等于 4,则追踪终止。 在全局情况下,遍历两条值为 2 的边之后,形状长度总和即已达到 4,因此追踪会停止。 如果使用本地值,每条路径上的本地值会变化,否则追踪将继续。

过滤器函数障碍 Function 值选项如下:

  • AVERAGE将计算输入值的平均值。
  • COUNT将识别要素数量。
  • MAX将识别输入值的最大值。
  • MIN将识别输入值的最小值。
  • ADD将计算各值的总和。
  • SUBTRACT将计算各值之间的差值。 子网控制器和循环追踪类型不支持减函数。

过滤器函数障碍 Operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

过滤器函数障碍 Use Local Values 选项如下:

  • TRUE将使用局部值。
  • FALSE将使用全局值。 这是默认设置。
Value Table
filter_scope
(可选)

指定是否在交汇点、边或这两处应用特定类别的过滤器。 例如,如果定义了用于停止追踪的过滤器障碍,其中 Device Status 等于 Open 并将遍历范围仅设置为边,则即使追踪遇到开路设备,追踪也不会停止,因为 Device Status 仅适用于交汇点。 换言之,此参数会向追踪指出是否要忽略交汇点、边或这两者。

  • BOTH_JUNCTIONS_AND_EDGES过滤器将同时应用于交汇点和边。 这是默认设置。
  • JUNCTIONS_ONLY过滤器将仅应用于交汇点。
  • EDGES_ONLY过滤器将仅应用于边。
String
filter_bitset_network_attribute_name
(可选)

将用于按 bitset 过滤的网络属性的名称。 此参数仅适用于上溯、下溯和循环追踪类型。 此参数可用于在追踪过程中添加特殊逻辑,以便追踪能够更好地反映真实世界的场景。 例如,对于循环追踪而言,Phases current 网络属性可以确定该循环是否为实际的电气循环(相同的相在循环 A 中各处均有电流通过),并且追踪结果只返回实际的电气循环。 上溯追踪的示例如下;如果追踪配电网络时指定 Phases current 网络属性,则追踪结果将只包含在网络属性中指定的有效路径,而不是所有路径。

String
filter_nearest
(可选)

指定是否使用 k-最近邻算法在给定距离内返回一些特定类型的要素。 可以提供计数、成本以及类别和/或资产类型的集合。

  • FILTER_BY_NEAREST将使用 k-最近邻算法来返回 nearest_countnearest_cost_network_attributenearest_categoriesnearest_assets 参数中指定的一定数量的要素。
  • DO_NOT_FILTERk 最近邻算法不会用于过滤结果。 这是默认设置。
Boolean
nearest_count
(可选)

filter_nearest 设置为 FILTER_BY_NEAREST 时,要返回的要素数量。

Long
nearest_cost_network_attribute
(可选)

filter_nearest 设置为 FILTER_BY_NEAREST 时,将用于计算接近度、成本或距离的数字网络属性,例如形状长度。

String
nearest_categories
[nearest_categories,...]
(可选)

filter_nearestFILTER_BY_NEAREST 时,将返回的类别(例如保护类别)。

String
nearest_assets
[nearest_assets,...]
(可选)

filter_nearest 设置为 FILTER_BY_NEAREST 时,将返回的资产组和资产类型,例如,ElectricDistributionDevice/Transformer/Step Down。

String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(可选)

将应用于追踪结果的计算函数。

函数组件如下:

  • Function - 从大量计算函数中进行选择。
  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Filter Name - 按属性名称过滤函数结果。
  • Filter Operator - 从大量运算符中进行选择。
  • Filter Type - 从大量的过滤类型中进行选择。
  • Filter Value - 提供输入过滤属性的特定值。

函数 Function 值选项如下:

  • AVERAGE将计算输入值的平均值。
  • COUNT将识别要素数量。
  • MAX将识别输入值的最大值。
  • MIN将识别输入值的最小值。
  • ADD将计算输入值的总和。
  • SUBTRACT将计算输入值之间的差值。子网控制器和循环追踪类型不支持减函数。

例如,起点要素的值为 20。 下一个要素的值为 30。 如果您正在使用 MINIMUM 函数,则结果为 20;使用 MAXIMUM 函数,结果为 30;使用 ADD 函数,结果为 50;使用 AVERAGE 函数,结果为 25;使用 COUNT 函数,结果为 2;使用 SUBTRACT 函数,结果为 -10。

Filter Operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

函数 Filter Type 值选项如下:

  • SPECIFIC_VALUE按特定值过滤。
  • NETWORK_ATTRIBUTE按网络属性过滤。
Value Table
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(可选)

指定要传播的网络属性以及传播将在追踪过程中的发生方式。 传播的类属性表示子网控制器上已传播至子网余下要素的关键值。 例如,在配电模型中,您可传播相位值。

传播程序组件如下:

  • Attribute - 选择按系统中定义的任何网络属性进行过滤。
  • Substitution Attribute - 使用替换值而不是 bitset 网络属性值。 替换是基于正在传递的网络属性中的位数进行编码的。 替换是指同相位的某个位到另一个位的映射。 例如对于相 AC 而言,可通过一个替换将位 A 映射到 B,将位 C 映射到 null。 在该示例中,1010(相 AC)的替换是 0000-0010-0000-0000 (512)。 该替换将捕捉映射,以通知您相 A 被映射到 B,且相 C 被映射到 null 而非相反(即相 A 未映射到 null,且相 C 未映射到 B)。
  • Function - 从大量计算函数中进行选择。
  • Operator - 从大量运算符中进行选择。
  • Value - 提供会基于运算符值导致终止的输入属性类型的特定值。

传播程序 Function 值选项如下:

  • PROPAGATED_BITWISE_AND将比较一个要素与下一个要素的值。
  • PROPAGATED_MIN将确定最小值。
  • PROPAGATED_MAX将确定最大值。

传播程序 Operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

注:

此参数仅可在 Python 中获得。

Value Table
output_assettypes
[output_assettypes,...]
(可选)

过滤要包含在结果中的输出资产类型 - 例如,仅返回架空变压器。

String
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(可选)

按网络属性或类别返回的要素类型。 例如,如果将追踪配置为“过滤掉除水龙头要素外的所有要素”,那么未分配水龙头类别的追踪要素均不会包含在结果中。 任何追踪的要素都会返回到结果选择集中。 如果要使用多个属性,可使用 Combine Using 选项来定义 And 或 Or 条件。

输出条件组件如下:

  • Name - 按系统中定义的任何网络属性进行过滤。
  • Operator - 从大量运算符中进行选择。
  • Type - 从 name 参数指定的值中选择特定值或网络属性。
  • Value - 提供会基于运算符值导致终止的输入属性类型的特定值。
  • Combine Using - 如果要添加多个属性,则设置此值。您可以使用 And 或 Or 条件来对它们进行组合。

输出条件 Operator 值选项如下:

  • IS_EQUAL_TO属性与值相等。
  • DOES_NOT_EQUAL属性与值不相等。
  • IS_GREATER_THAN属性大于值。
  • IS_GREATER_THAN_OR_EQUAL_TO属性大于或等于值。
  • IS_LESS_THAN属性小于值。
  • IS_LESS_THAN_OR_EQUAL_TO属性小于或等于值。
  • INCLUDES_THE_VALUES值中的所有位都存在于属性中的“按位与”运算(按位与 == 值)。
  • DOES_NOT_INCLUDE_THE_VALUES并非值中的所有位都存在于属性中的“按位与”运算(按位与 != 值)。
  • INCLUDES_ANY值中至少有一位存在于属性中的“按位与”运算(按位与 == True)。
  • DOES_NOT_INCLUDE_ANY值中的所有位均未存在于属性中的“按位与”运算(按位与 == False)。

了解有关按位运算符的详细信息

输出条件 Type 值选项如下:

  • SPECIFIC_VALUE按特定值过滤。
  • NETWORK_ATTRIBUTE按网络属性过滤。

输出条件 Combine Using 值选项如下:

  • AND组合条件。
  • OR满足任一条件时使用。

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

Value Table
include_isolated_features
(可选)

指定追踪结果中是否包含孤立要素。 此参数仅在运行孤立追踪时使用。

  • INCLUDE_ISOLATED_FEATURES追踪结果中将包含孤立要素。
  • EXCLUDE_ISOLATED_FEATURES追踪结果中将不包含孤立要素。 这是默认设置。
注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 10.7 或更高版本。

Boolean
ignore_barriers_at_starting_points
(可选)

指定是否在追踪配置中忽略起点处的动态障碍。 这在执行上游保护设备追踪并使用所发现的保护设备(屏障)作为起始点以找到后续上游保护设备时可能非常有用。

  • IGNORE_BARRIERS_AT_STARTING_POINTS追踪过程中将忽略起点处的障碍。
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS追踪过程中不会忽略起点处的障碍。 这是默认设置。
Boolean
include_up_to_first_spatial_container
(可选)

指定返回的容器是否仅限于追踪结果中每个网络元素的第一个空间容器(包括第一个空间容器)。 如果没有遇到空间容器,但是存在给定网络元素的非空间容器,则所有非空间容器都将包含在结果中。 仅当将 Include Containers 设置为 INCLUDE_CONTAINERS 时,才会启用此参数。

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER当沿追踪路径遇到嵌套包含关联时,结果中仅返回遇到次数最多并包括第一个空间容器的容器。 如果不存在空间容器,则给定网络元素的所有非空间容器都将包含在结果中。
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER所有容器都将在结果中返回。 这是默认设置。
Boolean
result_types
[result_types,...]
(可选)

指定追踪返回的结果的类型。

  • SELECTION追踪结果将作为相应网络要素上的选择集返回。 这是默认设置。
  • AGGREGATED_GEOMETRY追踪结果按几何类型聚合,并存储在活动地图的图层中显示的多部件要素类中。
String
allow_indeterminate_flow
(可选)

指定是否追踪具有不确定流向的要素。 仅在运行上溯追踪、下溯追踪或孤立追踪时应用此参数。

  • TRACE_INDETERMINATE_FLOW将追踪具有不确定流向的要素。 这是默认设置。
  • IGNORE_INDETERMINATE_FLOW具有不确定流向的要素将停止可遍历性并且不会被追踪。
Boolean
validate_locatability
(可选)

指定当遇到非空间交汇点或边对象在遍历要素的关联层次结构中没有关联的容器或结构时,是否返回错误。 此参数可确保追踪返回的非空间对象与空间要素关联。

  • VALIDATE_LOCATABILITY当遇到非空间交汇点或边对象在遍历要素的关联层次结构中没有关联的容器或结构时,追踪将返回错误。
  • DO_NOT_VALIDATE_LOCATABILITY追踪不会检查是否存在无法定位的对象并返回结果,无论遍历要素的关联层次结构中是否存在无法定位的对象。 这是默认设置。
Boolean
use_digitized_direction
(可选)

指定上游和下游追踪操作是否将使用线的数字化方向、关联中边缘对象的“起始”和“终止”全局 ID 以及 Flow direction 属性来确定流向。 当 trace_type 参数设置为 UPSTREAMDOWNSTREAM 选项时,此参数仅适用于 Utility Network 版本 7 及更高版本。

  • USE_DIGITIZED_DIRECTION追踪操作将使用线的数字化方向、关联中边对象的“起始”和“结束”全局 ID 以及流向属性来确定流向。 使用此选项,domain_networktiertarget_tier 参数将被忽略。
  • IGNORE_DIGITIZED_DIRECTION跟踪操作将根据子网控制器的位置确定流向。 这是默认设置。
注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 11.3 或更高版本。

Boolean
synthesize_geometries
(可选)

指定是否为作为跟踪操作的一部分遍历的关联和边缘对象推断和创建(合成)几何。 此参数仅适用于聚合几何结果类型。

  • DO_NOT_SYNTHESIZE_GEOMETRIES不会为遍历的关联和边对象合成几何。 这是默认设置。
  • SYNTHESIZE_GEOMETRIES将为输出 Trace_Results_Aggreerated_Lines 要素类中遍历的关联和边对象推断并创建几何。

注:

对于企业级地理数据库,此参数需要 ArcGIS Enterprise 11.3 或更高版本。

Boolean

派生输出

名称说明数据类型
out_utility_network

更新的公共设施网络。

Utility Network

代码示例

AddTraceConfiguration 示例(Python 窗口)

以下 Python 窗口脚本演示了如何使用 AddTraceConfiguration 函数。

import arcpy
arcpy.un.AddTraceConfiguration(
        r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM", 
        "Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution", 
        "Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT", 
        "EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None, 
        None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES", 
        '', "DO_NOT_FILTER", None, '', None, None, None, None, None, None, 
        "EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", 
        "DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None, 
        "TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")

环境

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

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题