分割 (分析)

在 Advanced 许可等级下可用。

摘要

分割具有叠加要素的输入以创建输出要素类的子集。

插图

分割工具图示
根据六个叠加分割要素中的四个,将输入要素分割为四个输出要素类。 这六个分割要素与六个唯一分割字段值相对应。

使用情况

  • 分割字段参数的唯一值构成输出要素类的名称。 它们保存在目标工作空间中。

  • 分割要素数据集必须是面。

  • 分割字段数据类型必须是字符。 其唯一值生成输出要素类的名称。

  • 分割字段的唯一值必须以有效字符开头。 如果目标工作空间是地理数据库,则字段值必须以字母开头。 以数字开头的字段值(例如 350 degrees)将导致错误。 但是,Shapefile 名称可以使用数字开头,文件夹目标工作空间准许以数字开头的字段值。

  • 目标工作空间必须已经存在。

  • 输出要素类的总数等于唯一分割字段值的数量,其范围为输入要素值与分割要素值的叠加部分。

  • 每个输出要素类的要素属性表所包含的字段与输入要素属性表中的字段相同。

  • 根据注记字符串左下角起点所在的分割要素面对注记要素进行分割并将其保存在输出要素中。

  • 输入要素类的属性值将被复制到输出要素类。 但是,如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项,那么计算输出属性值时将按输入属性值的一定比例进行计算。 如果启用了使用比率策略选项,执行叠加操作时,对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。 输出值将根据输入要素几何被分割的比率得出。 例如,如果输入几何被分割成相等的两部分,则每个新要素的属性值都等于输入要素属性值的一半。 使用比率策略仅适用于数值字段类型。

    警告:

    地理处理工具不支持地理数据库要素类或表字段分割策略

  • 为了获得更好的性能和可扩展性,此工具将使用切片过程来处理非常大的数据集。 有关详细信息,请参阅大型数据集的切片处理

参数

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

要分割的要素。

Feature Layer
分割要素

包含表格字段的面要素,其中表格字段的唯一值用于分割输入要素并提供输出要素类的名称。

Feature Layer
分割字段

用于分割输入要素的字符字段。 此字段值可标识用于创建每个输出要素类的分割要素。 “分割字段”的唯一值用于生成输出要素类的名称。

Field
目标工作空间

用来存储输出要素类的现有工作空间。

Workspace ; Feature Dataset
XY 容差
(可选)

所有要素坐标(节点和折点)之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。 如果将此值设置的较高,则数据会具有较低的坐标精度;如果将此值设置的较低,则数据会具有较高的坐标精度。

警告:

更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下,将使用输入要素类的空间参考 x,y 容差属性。

Linear Unit

派生输出

标注说明数据类型
更新的目标工作空间

通过分割输入而创建的包含要素类的工作空间。

Workspace; Feature Dataset

arcpy.analysis.Split(in_features, split_features, split_field, out_workspace, {cluster_tolerance})
名称说明数据类型
in_features

要分割的要素。

Feature Layer
split_features

包含表格字段的面要素,其中表格字段的唯一值用于分割输入要素并提供输出要素类的名称。

Feature Layer
split_field

用于分割输入要素的字符字段。 此字段值可标识用于创建每个输出要素类的分割要素。 “分割字段”的唯一值用于生成输出要素类的名称。

Field
out_workspace

用来存储输出要素类的现有工作空间。

Workspace ; Feature Dataset
cluster_tolerance
(可选)

所有要素坐标(节点和折点)之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。 如果将此值设置的较高,则数据会具有较低的坐标精度;如果将此值设置的较低,则数据会具有较高的坐标精度。

警告:

更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下,将使用输入要素类的空间参考 x,y 容差属性。

Linear Unit

派生输出

名称说明数据类型
out_workspace2

通过分割输入而创建的包含要素类的工作空间。

Workspace; Feature Dataset

代码示例

Split 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Split("Habitat_Analysis.gdb/vegtype", "climate.shp", "Zone", 
                     "C:/output/Output.gdb", "1 Meters")
Split 示例 2(独立脚本)

将植被图层按气候带分割成单独的要素类。

# Name: Split.py
# Description: Split vegetation layer into separate feature classes 
# for each climate zone

# import system modules 
import arcpy 

# Set environment settings
arcpy.env.workspace = "C:/data"

# Split vegetation layer by climate zones, write to Output.gdb
veg = "Habitat_Analysis.gdb/vegtype"
splitFeatures = "climate.shp"
splitField = "Zone"
outWorkspace = "C:/output/Output.gdb"
clusterTol = "1 Meters"

arcpy.analysis.Split(veg, splitFeatures, splitField, outWorkspace, 
                     clusterTol)

环境

特殊情况

并行处理因子

此工具支持并行处理因子环境。 如果未设置环境(默认)或设置为 0,则将禁用并行处理;不会使用并行处理,而是按顺序进行处理。 如将环境设置为 100,则将启用并行处理;将使用并行处理,并且将进行并行处理。 启用并行处理时,最多将使用 10 个内核。

目前,面-面、线-面以及点-面叠加操作支持并行处理。