Eliminate (Data Management)

License Level:BasicStandardAdvanced

Summary

Eliminates polygons by merging them with neighboring polygons that have the largest area or the longest shared border. Eliminate is often used to remove small sliver polygons that are the result of overlay operations, such as Intersect or Union.

Illustration

Eliminate illustration

Usage

Syntax

Eliminate_management (in_features, out_feature_class, {selection}, {ex_where_clause}, {ex_features})
ParameterExplanationData Type
in_features

The layer whose polygons will be merged into neighboring polygons.

Feature Layer
out_feature_class

The feature class to be created.

Feature Class
selection
(Optional)

These options specify which method will be used for eliminating features.

  • LENGTHMerges a selected polygon with a neighboring unselected polygon by dropping the shared border. The neighboring polygon is the one with the longest shared border. This is the default.
  • AREAMerges a selected polygon with a neighboring unselected polygon by dropping the shared border. The neighboring polygon is the one with the largest area.
Boolean
ex_where_clause
(Optional)

An SQL expression used to identify features that will not be altered. For more information on SQL syntax see the help topic SQL reference for query expressions used in ArcGIS.

SQL Expression
ex_features
(Optional)

An input polyline or polygon feature class or layer that defines polygon boundaries, or portions thereof, that should not be eliminated.

Feature Layer

Code Sample

Eliminate example (Python window)

The following Python window script demonstrates how to use the Eliminate tool in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Census"
arcpy.MakeFeatureLayer_management("blockgrp", "blocklayer")
arcpy.SelectLayerByAttribute_management("blocklayer", "NEW_SELECTION", 
                                        '"Area_Sq_Miles" < 0.15')
arcpy.Eliminate_management("blocklayer", "C:/output/output.gdb/eliminate_output", 
                           "LENGTH", '"OBJECTID" = 9')
Eliminate example 2 (stand-alone script)

The following stand-alone script demonstrates how to use the Eliminate tool.

# Name: Eliminate_Example2.py
# Description: Eliminate features based on a selection.
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Census"
 
# Set local variables
inFeatures = "blockgrp"
tempLayer = "blocklayer"
expression = '"Area_Sq_Miles" < 0.15'
outFeatureClass = "C:/output/output.gdb/eliminate_output"
exclusionExpression = '"OBJECTID" = 9'
 
# Execute MakeFeatureLayer
arcpy.MakeFeatureLayer_management(inFeatures, tempLayer)
 
# Execute SelectLayerByAttribute to define features to be eliminated
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION", expression)
 
# Execute Eliminate
arcpy.Eliminate_management(tempLayer, outFeatureClass, "LENGTH", 
                           exclusionExpression)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
5/7/2015