Split (Analysis)

Available with Advanced license.

Summary

Splits an input with overlaying features to create a subset of output feature classes.

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

Illustration

Split
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

  • The Split Features dataset must be polygons.

  • The Split Field data type must be character. Its unique values form the names of output feature classes.

  • The split field's unique values must start with a valid character. If the target workspace is a geodatabase, the field's values must begin with a letter. Field values that begin with a number as in "350 degrees" cause an error. Exception: Shapefile names can begin with a number, and a folder target workspace allows field values that begin with a number.

  • The target workspace must already exist.

  • The total number of output feature classes equals the number of unique Split Field values and the extent of overlay of the Input Features with the Split Features.

  • The feature attribute table of each output feature class contains the same fields as the Input Features attribute table.

  • Annotation features are split and saved in the output features based on the Split Features polygon in which the lower left starting point of the annotation string falls.

  • Attribute values from the input feature classes will be copied to the output feature class. However, if the input is a layer or layers created by the Make Feature Layer tool and a field's Use Ratio Policy is checked, then a ratio of the input attribute value is calculated for the output attribute value. When Use Ratio Policy is enabled, whenever a feature in an overlay operation is split, the attributes of the resulting features are a ratio of the attribute value of the input feature. The output value is based on the ratio in which the input feature geometry was divided. For example, if the input geometry was divided equally, each new feature's attribute value is assigned one-half of the value of the input feature's attribute value. Use Ratio Policy only applies to numeric field types.

    Caution:

    Geoprocessing tools do not honor geodatabase feature class or table field split policies.

  • This tool will use a tiling process to handle very large datasets for better performance and scalability. For more details, see Geoprocessing with large datasets.

  • This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled. Setting the environment to 100 will cause parallel processing to be enabled.

Syntax

arcpy.analysis.Split(in_features, split_features, split_field, out_workspace, {cluster_tolerance})
ParameterExplanationData Type
in_features

The features to be split.

Feature Layer
split_features

Polygon 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 existing 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.

Caution:

Changing this parameter's value may cause failure or unexpected results. It is recommended that this parameter not be modified. It has been removed from view in the tool dialog. By default, the input feature class's spatial reference x,y tolerance property is used.

Linear Unit

Derived Output

NameExplanationData Type
out_workspace2

The workspace containing the features classes created by splitting the input.

Workspace; Feature Dataset

Code sample

Split example 1 (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 2 (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

# 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)

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Yes

Related topics