Split (Coverage)

Summary

Clips portions of the input coverage into multiple coverages.

Each new output coverage contains only those portions of the input coverage features overlapped by the split coverage polygons. The unique values in the Split Item are used to name the output coverages. The number of output coverages is determined by the number of unique values in the Split Item.

Learn more about how Split works

Illustration

Split illustration

Usage

Syntax

Split_arc (in_cover, split_cover, split_item, {path}, {feature_type}, {fuzzy_tolerance})
ParameterExplanationData Type
in_cover

The coverage to be split.

Coverage
split_cover

The coverage used to split the input coverage.

Coverage
split_item

The item in the split coverage that will be used to split the input coverage. The unique values in the Split Item are used to name the output coverages. The number of output coverages is determined by the number of unique values in the Split Item.

ArcInfo Item
path
(Optional)

The workspace in which the output coverage will be maintained.

Folder ; Workspace
feature_type
(Optional)

The feature classes to be split:

  • POLYPolygons will be split. This is the default option.
  • LINEArcs will be split.
  • POINTPoints will be split.
  • NETPolygons and lines will be split.
  • LINKPoints and lines will be split.
  • RAWArcs, data points, and annotation in a coverage that does not have topology (no attribute files) will be split. Attributes are ignored.
String
fuzzy_tolerance
(Optional)

The minimum distance between coordinates in each output coverage. By default, the minimum fuzzy tolerance value from the input coverage and split coverage is used.

Learn more about how the default fuzzy tolerance is calculated

Double

Code Sample

Split example (stand-alone script)

The following stand-alone script demonstrates how to split one coverage into multiple output coverages.

# Name: Split_Example.py
# Description: Splits one coverage into multiple output coverages.
# Requirements: ArcInfo Workstation
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inCover = "county"
splitCover = "citylim"
splitItem = "citycode"
path = "C:/output/city"
featureType = "LINE"

# Execute split
arcpy.Split_arc(inCover, splitCover, splitItem, path, featureType, "")

Environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: No
ArcInfo: Requires ArcInfo Workstation installed

Published 6/8/2010