取消线分割 (数据管理)

描述

合并具有重合端点及公共属性值（可选）的线。

插图

使用方法

• 可使用各种统计对通过此工具聚合的要素属性值进行汇总或描述。以“统计类型 + 下划线 + 输入字段名”为命名标准，将用来汇总属性的统计以单个字段的形式添加到输出要素类中。例如，如果对名为 POP 的字段使用 SUM 统计，则输出中将存在名为 SUM_POP 的字段。

• 可用物理内存量会对可处理并取消分割为单个输出线要素的输入要素的数量（和复杂性）造成限制。此限制会导致错误，因为取消分割过程需要的内存量可能会超过可用的内存量。为防止出现此问题，取消线分割可以使用适当的切片算法对输入要素进行分割和处理。要确定要素是否已被切片，可对此工具的结果运行频数工具，将频数字段参数指定为融合字段参数中使用的字段。已对频数值为 2 的所有记录进行切片。会在输出要素中保留切片边界，以防止创建的要素过大而无法被 ArcGIS 使用。

  警告：

  当原始的处理使用适当的切片对输入进行分割和处理后，对上一次取消分割的输出再次运行取消线分割几乎不会减少输出中要素的数量。任何输出要素的最大大小都取决于运行时的可用内存量；因此，包含切片的输出是一个指示器，指示使用可用资源再进行取消分割会导致内存不足，或生成无法使用的要素。此外，再次以相同的方式对创建的输出结果运行取消线分割工具，可能会导致系统性能下降而一无所获，而且还可能会导致异常失败。

• 空值将被排除在所有统计计算之外。例如，10、5 和空值的平均值为 7.5 ((10+5)/2)。计数可返回统计计算中所包括值的数目，如本例中为 2。

语法

UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {statistics_fields})

参数	说明	数据类型
in_features	要聚合的线要素。	Feature Layer
out_feature_class	要创建的将包含聚合要素的要素类。	Feature Class
dissolve_field [dissolve_field,...] （可选）	要聚合要素的一个或多个字段。	Field
statistics_fields [[field, {statistic_type}],...] （可选）	指定包含用于计算指定统计数据的属性值的数值字段。可以指定多项统计数据和字段组合。空值将被排除在所有统计计算之外。 可使用第一种和最后一种统计来对文本属性字段进行汇总。可使用任何一种统计来对数值属性字段进行汇总。 可用统计类型如下： SUM - 添加指定字段的合计值。 MEAN - 计算指定字段的平均值。 MIN - 查找指定字段所有记录的最小值。 MAX - 查找指定字段所有记录的最大值。 RANGE - 查找指定字段的值范围（最大值 - 最小值）。 STD - 查找指定字段中的值的标准差。 COUNT - 查找统计计算中包括的值的数目。计数范围包括除空值外的每个值。要确定字段中的空值数，请在相应字段上创建计数，然后在另一个不包含空值的字段上创建计数（例如 OID，如果存在的话），然后将这两个值相减。 FIRST - 查找输入中的第一条记录，并使用该记录的指定字段值。 LAST - 查找输入中最后一条记录，并使用该记录的指定字段值。 MEDIAN - 计算指定字段所有记录的中值。 VARIANCE - 计算指定字段所有记录的方差。 UNIQUE - 计算指定字段的唯一值数量。	Value Table
statistics_fields [[field, {statistic_type}],...] （可选）	指定包含用于计算指定统计数据的属性值的数值字段。可以指定多项统计数据和字段组合。空值将被排除在所有统计计算之外。 可使用第一种和最后一种统计来对文本属性字段进行汇总。可使用任何一种统计来对数值属性字段进行汇总。 可用统计类型如下： SUM - 添加指定字段的合计值。 MEAN - 计算指定字段的平均值。 MIN - 查找指定字段所有记录的最小值。 MAX - 查找指定字段所有记录的最大值。 RANGE - 查找指定字段的值范围（最大值 - 最小值）。 STD - 查找指定字段中的值的标准差。 COUNT - 查找统计计算中包括的值的数目。计数范围包括除空值外的每个值。要确定字段中的空值数，请在相应字段上创建计数，然后在另一个不包含空值的字段上创建计数（例如 OID，如果存在的话），然后将这两个值相减。 FIRST - 查找输入中的第一条记录，并使用该记录的指定字段值。 LAST - 查找输入中最后一条记录，并使用该记录的指定字段值。 MEDIAN - 计算指定字段所有记录的中值。 VARIANCE - 计算指定字段所有记录的方差。 UNIQUE - 计算指定字段的唯一值数量。	Value Table

代码示例

UnsplitLine 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 UnsplitLine 工具。

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.UnsplitLine_management("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])

UnsplitLine 示例 2（独立脚本）

以下独立脚本演示了如何使用 UnsplitLine 工具。

# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
 
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
 
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

环境

当前工作空间, 临时工作空间, 输出坐标系, 地理变换, 范围, XY 分辨率, XY 容差, 输出包含 M 值, M 分辨率, M 容差, 输出包含 Z 值, 默认输出 Z 值, Z 分辨率, Z 容差, 限定的字段名, 输出配置关键字, 自动提交, 输出 XY 值域, 输出 M 值域, 输出 Z 值域

许可信息

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