导出子网 (公共设施网络)

描述

将公共设施网络的子网导出为 JSON 文件。如果 Is deleted 属性设置为 true，则该工具也可以用于删除子网表中的行。这表示子网控制器已从子网中移除。

了解有关导出子网的详细信息

使用方法

• 子网必须规整；首先运行更新子网工具。

• Trace Parameters 类别中的参数仅可通过 Python 来执行。

• 使用企业级地理数据库时，必须满足以下要求：
  • 输入公共设施网络参数值必须来自公共设施网络服务。

• 在启用设置导出确认参数后，必须满足以下条件：

  • 必须启用网络拓扑。

  • 企业级地理数据库具有以下附加要求：
    • 此工具在执行时必须连接到默认版本。
    • 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者。

• ArcGIS Pro 2.3 中添加了以下参数：包括几何、结果类型、结果网络属性和结果字段。使用这些参数时，输出 JSON 文件格式会有所不同。将这些参数与企业级地理数据库结合使用时，需要 ArcGIS Enterprise 10.7 或更高版本。查看输出 JSON 响应语法。

语法

arcpy.un.ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields})

参数	说明	数据类型
in_utility_network	包含要导出的子网的公共设施网络。	Utility Network; Utility Network Layer
domain_network	包含子网的域网络。	String
tier	包含子网的层。	String
subnetwork_name	要导出的子网的名称。选择一个特定源可导出相应的子网信息。	String
export_acknowledged	指定是否更新 Subnetworks 表中相应控制器的 LASTACKEXPORTSUBNETWORK 属性以及 SubnetLine 要素类中的要素。 ACKNOWLEDGE —更新 Subnetworks 表中相应控制器的 LASTACKEXPORTSUBNETWORK 属性。如果源已标记为删除 (Is deleted = True)，则将从子网表中将其删除。此选项要求输入公共设施网络引用默认版本。 NO_ACKNOWLEDGE —不更新 Subnetworks 表中相应控制器的 LASTACKEXPORTSUBNETWORK 属性。这是默认设置。	Boolean
out_json_file	要生成的 JSON 文件的名称和位置。	File
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] （可选）	基于与网络属性的比较或对类别字符串的检查，对要素设置可遍历性障碍条件。条件障碍使用网络属性、运算符和类型以及属性值。例如，当要素的 Device Status 属性等于 Open 的特定值时，将停止追踪。当要素满足此条件时，追踪将停止。如果您要使用多个属性，可使用 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 —满足任一条件障碍时使用。 注： 此参数仅可通过 Python 获得。 了解有关使用多条件表达式的详细信息	Value Table
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] （可选）	基于函数对要素设置可遍历性障碍。函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。例如，所经过的每条线的长度和为目前经过的总距离。当经过的总长度达到指定值时，追踪将停止。 函数障碍组件如下： Function - 从大量不同的计算函数中进行选择。 Attribute - 选择按系统中定义的任何网络属性进行过滤。 Operator - 从大量不同的运算符中进行选择。 Value - 设置将导致终止的输入属性类型（若发现）的特定值。 Use Local Values - 计算每个方向的值，而不是整体全局值。例如，用于计算 Shape length 总和的函数障碍，其中，如果值大于或等于 4，则追踪终止。在全局情况下，遍历两条值为 2 的边之后，形状长度总和即已达到 4，因此追踪会停止。如果使用局部值，每条路径上的局部值会变化，因此追踪会持续得更远。 TRUE —使用局部值。 FALSE —使用全局值。这是默认设置。 函数障碍 function 选项的可能值如下： AVERAGE —输入值的平均值。 COUNT —要素数目。 MAX —输入值的最大值。 MIN —输入值的最小值。 ADD —加上这些值。 SUBTRACT —减去这些值。子网控制器和循环追踪类型不支持减法函数。 例如，起点要素的值为 20。下一个要素的值为 30。如果使用 Minimum 函数，则结果为 20；使用 Maximum 函数，结果为 30；使用 Add 函数，结果为 50；使用 Average 函数，结果为 25；使用 Count 函数，结果为 2；使用 Subtract 函数，结果为 -10。 函数障碍 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
include_barriers （可选）	指定追踪结果中是否包含可遍历性障碍要素。即使已在子网定义中进行了预设，可遍历性障碍仍可选。 INCLUDE_BARRIERS —追踪结果中包含可遍历性障碍。这是默认设置。 EXCLUDE_BARRIERS —追踪结果中不包含可遍历性障碍。 注： 此参数仅可通过 Python 获得。	Boolean
traversability_scope （可选）	指定要强制使用的可遍历性的类型。可遍历性范围指明是否在交汇点、边或这两处强制使用可遍历性。例如，如果定义了一个用于停止追踪的条件障碍，其中 DEVICESTATUS 设置为 Open 且遍历范围设置为仅边，则即使遇到开路设备，追踪也不会停止，因为 DEVICESTATUS 仅适用于交汇点。换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 BOTH_JUNCTIONS_AND_EDGES —将可遍历性同时应用于交汇点和边。 JUNCTIONS_ONLY —将可遍历性仅应用于交汇点。 EDGES_ONLY —将可遍历性仅应用于边。 注： 此参数仅可通过 Python 获得。	String
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_INLCUDE_ANY —按位与运算，其中值中的所有位均不存在于属性中（按位与 == False）。 注： 此参数仅可通过 Python 获得。	Value Table
include_geometry （可选）	指定是否在结果中包括几何。 INCLUDE_GEOMETRY —在结果中包括几何。 EXCLUDE_GEOMETRY —在结果中不包括几何。这是默认设置。 注： 对于企业级地理数据库，此参数要求 ArcGIS Enterprise 10.7 或更高版本。	Boolean
result_types [result_types,...] （可选）	指定要导出的结果类型。 CONNECTIVITY —返回通过几何重叠或连通性关联连接的要素。这是默认设置。 FEATURES —返回响应中的要素级别信息。 CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS —返回通过包含和结构附件关联关联的要素。 注： 对于企业级地理数据库，此参数要求 ArcGIS Enterprise 10.7 或更高版本。 包含和附件关联选项要求 ArcGIS Enterprise 10.8.1 或更高版本。	String
result_network_attributes [result_network_attributes,...] （可选）	将包含在结果中的网络属性。 注： 对于企业级地理数据库，此参数要求 ArcGIS Enterprise 10.7 或更高版本。	String
result_fields [[Feature Class, Field Name],...] （可选）	要素类中将作为结果返回的字段。字段的值将在子网中要素的结果中返回。 注： 对于企业级地理数据库，此参数要求 ArcGIS Enterprise 10.7 或更高版本。	Value Table

派生输出

名称	说明	数据类型
out_utility_network	更新的公共设施网络。	公共设施网络

代码示例

ExportSubnetwork 示例（Python 窗口）

将名为 RMT002 的源的相应子网信息导出为 JSON 文件。

import arcpy
arcpy.ExportSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE", 
                          "C:\\Temp\\RMT002clean.json")

环境

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

许可信息

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