在 Advanced 许可等级下可用。
描述
分割具有叠加要素的输入以创建输出要素类的子集。
分割字段参数的唯一值生成输出要素类的名称。它们保存在目标工作空间中。
插图
使用方法
分割要素数据集必须是面。
分割字段数据类型必须是字符。其唯一值生成输出要素类的名称。
分割字段的唯一值必须以有效字符开头。如果目标工作空间是地理数据库，则字段值必须以字母开头。像“350 degrees”这样以数字开头的字段值将导致错误。例外情况：Shapefile 名称可以使用数字开头，文件夹目标工作空间准许以数字开头的字段值。
目标工作空间必须已经存在。
输出要素类的总数等于唯一分割字段值的数量，其范围为输入要素与分割要素的叠加部分。
每个输出要素类的要素属性表所包含的字段与输入要素属性表中的字段相同。
根据注记字符串左下角起点所在的分割要素面对注记要素进行分割并将其保存在输出要素中。
输入要素类的属性值将被复制到输出要素类。但是，如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项，那么计算输出属性值时将按输入属性值的一定比例进行计算。如果启用了使用比率策略选项，执行叠加操作时，对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如，如果输入几何被分割成相等的两部分，则每个新要素的属性值都等于输入要素属性值的一半。使用比率策略仅适用于数值字段类型。
警告：
地理处理工具不支持地理数据库要素类或表字段分割策略。
此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息，请参阅对大型数据集进行地理处理。
此工具支持并行处理因子环境。如果环境未设置（默认值）或者设置为 0，则将禁用并行处理。将环境设置为 100 将启用并行处理。
语法
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 | 通过分割输入而创建的包含要素类的工作空间。 | 工作空间；要素数据集 |
代码示例
以下 Python 窗口脚本演示了如何使用 Split 工具。
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.Split_analysis("Habitat_Analysis.gdb/vegtype", "climate.shp", "Zone",
"C:/output/Output.gdb", "1 Meters")将植被图层按气候带分割成单独的要素类。
# 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.Split_analysis(veg, splitFeatures, splitField, outWorkspace,
clusterTol)环境
许可信息
- Basic: 否
- Standard: 否
- Advanced: 是