Split (Analysis)

License Level:BasicStandardAdvanced

Summary

Splitting the Input Features creates a subset of multiple output feature classes.

The Split Field's unique values form the names of the output feature classes. These are saved in the target workspace.

Illustration

Split illustration
The INPUT features are split into four OUTPUT feature classes based on four of six overlaying SPLIT FEATUREs. These six split features correspond to six unique split field values.

Usage

Syntax

Split_analysis (in_features, split_features, split_field, out_workspace, {cluster_tolerance})
ParameterExplanationData Type
in_features

The features to be split.

Feature Layer
split_features

The features containing a tabular field whose unique values are used to split the Input Features and provide the output feature classes' names.

Feature Layer
split_field

The character field used to split the Input Features. This field's values identify the Split Features used to create each output feature class. The Split Field's unique values provide the output feature classes' names.

Field
out_workspace

The workspace where the output feature classes are stored.

Workspace ; Feature Dataset
cluster_tolerance
(Optional)

The minimum distance separating all feature coordinates (nodes and vertices) as well as the distance a coordinate can move in X or Y (or both). Set the value to be higher for data that has less coordinate accuracy and lower for datasets with extremely high accuracy.

Linear unit

Code Sample

Split Example (Python Window)

The following Python Window script demonstrates how to use the Split tool.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.Split_analysis("Habitat_Analysis.gdb/vegtype", "climate.shp", "Zone", "C:/output/Output.gdb", "1 Meters")
Split Example (Stand-alone script)

Split vegetation layer into separate feature classes for each climate zone.

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

# import system modules 
import arcpy 
from arcpy import env

# Set environment settings
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)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
5/6/2013