标注 | 说明 | 数据类型 |
输入要素 | 要聚合的线要素。 | Feature Layer |
输出要素类 | 要创建的将包含聚合要素的要素类。 | Feature Class |
融合字段 (可选) | 将进行聚合的要素的一个或多个字段。 如果未指定字段,该工具会将所有要素融合在一起。 | Field |
统计数据字段 (可选) | 指定包含将用于计算指定统计数据的属性值的一个或多个字段。 可以指定多项统计和字段组合。 空值将被排除在所有计算之外。 默认情况下,该工具不会计算任何统计数据。 可使用任何一种统计来对数值属性字段进行汇总。 可以使用最小值、最大值、计数、第一个、最后一个、唯一、串连和模式统计数据对文本属性字段进行汇总。
| Value Table |
串连分隔符 (可选) | 当串连选项用于统计数据字段参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。 | String |
摘要
用于聚合具有重合端点及公共属性值(可选)的线要素。
插图
使用情况
可使用各种统计对通过此工具聚合的要素属性进行汇总或描述。 以“统计类型 + 下划线 + 输入字段名”为命名标准,将用来汇总属性的统计以单个字段的形式添加到输出要素类中。 例如,如果对名为 POP 的字段使用 SUM 统计类型,则输出中将包含名为 SUM_POP 的字段。
可用物理内存量会对可处理并聚合为单个输出线要素的输入要素的数量(和复杂性)造成限制。 此限制会导致错误,因为取消分割过程需要的内存量可能会超过可用的内存量。 为防止出现此问题,取消线分割可以使用适当的切片算法对输入要素进行分割和处理。 要确定要素是否已被切片,可对此工具的结果运行频数工具,将频数字段参数指定为融合字段参数中使用的字段。 已对频数值为 2 的所有记录进行切片。 会在输出要素中保留切片边界,以防止创建的要素过大而无法被 ArcGIS 使用。
警告:
当原始的处理使用适当的切片对输入进行分割和处理后,对上一次取消分割过程的输出再次运行取消线分割几乎不会减少输出中要素的数量。 任何输出要素的最大大小都取决于运行时的可用内存量;包含切片的输出是一个指示器,指示使用可用资源再进行聚合会导致内存不足,或生成无法使用的要素。 此外,再次以相同的方式对创建的输出结果运行取消线分割工具,可能会导致系统性能下降而一无所获,而且还可能会导致异常失败。
空值将被排除在所有统计计算之外。 例如,10、5 和空值的平均值为 7.5 ((10+5)/2)。 计数可返回统计计算中所包括值的数目,如本例中为 2。
参数
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}],...] (可选) | 指定包含将用于计算指定统计数据的属性值的一个或多个字段。 可以指定多项统计和字段组合。 空值将被排除在所有计算之外。 默认情况下,该工具不会计算任何统计数据。 可使用任何一种统计来对数值属性字段进行汇总。 可以使用最小值、最大值、计数、第一个、最后一个、唯一、串连和模式统计数据对文本属性字段进行汇总。
| Value Table |
concatenation_separator (可选) | 当 CONCATENATION 选项用于 statistics_fields 参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。 | String |
代码示例
以下 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 函数。
# 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: 是