取消线分割 (数据管理)

摘要

用于聚合具有重合端点及公共属性值(可选)的线要素。

插图

“取消线分割”工具图示

使用情况

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

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

    警告:

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

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

参数

标注说明数据类型
输入要素

要聚合的线要素。

Feature Layer
输出要素类

要创建的将包含聚合要素的要素类。

Feature Class
融合字段
(可选)

将进行聚合的要素的一个或多个字段。 如果未指定字段,该工具会将所有要素融合在一起。

Field
统计数据字段
(可选)

指定包含将用于计算指定统计数据的属性值的一个或多个字段。 可以指定多项统计和字段组合。 空值将被排除在所有计算之外。

默认情况下,该工具不会计算任何统计数据。

可使用第一种和最后一种统计来对文本属性字段进行汇总。 可使用任何一种统计来对数值属性字段进行汇总。

可用统计类型如下:

  • 总和 - 将指定字段的值相加在一起。
  • 平均值 - 将计算指定字段的平均值。
  • 最小值 - 将标识指定字段所有记录的最小值。
  • 最大值 - 将标识指定字段所有记录的最大值。
  • 范围 - 将计算指定字段的值范围(最大值 - 最小值)。
  • 标准差 - 将计算指定字段值的标准差。
  • 计数 - 将标识计算中包括的值的数目。 计数包括除空值外的所有值。 要确定字段中的空值数,请在相应字段上创建计数,然后在另一个不包含空值的字段上创建计数(例如 OID,如果存在的话),然后将这两个值相减。
  • 第一个 - 将使用输入中第一条记录的指定字段值。
  • 最后一个 - 将使用输入中最后一条记录的指定字段值。
  • 中值 - 将计算指定字段所有记录的中值。
  • 方差 - 将计算指定字段所有记录的方差。
  • 唯一值 - 将计算指定字段的唯一值数量。
  • 串连 - 指定字段的值将被串连。 可以使用串连分隔符参数分隔这些值。
Value Table
串连分隔符
(可选)

串连选项用于统计数据字段参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。

String

arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {concatenation_separator})
名称说明数据类型
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 - 将计算指定字段的唯一值数量。
  • CONCATENATE - 指定字段的值将被串连。 可以使用 concatenation_separator 参数分隔这些值。
Value Table
concatenation_separator
(可选)

CONCATENATION 选项用于 statistics_fields 参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。

String

代码示例

UnsplitLine 示例(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.management.UnsplitLine("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"]
 
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)

许可信息

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

相关主题