Find Overlaps (Intelligence)

Summary

Finds overlapping areas in a feature class and provides a count for the number of overlaps.

Usage

• Input Features must be a simple polygon feature class. Complex features such as annotation classes and utility networks are not supported.

• Input Features with the same Group Field values will be intersected together; other areas are ignored.

• One centroid is created for the intersection of each group in Output Centroid features.

• Output Intersections includes a field named overlaps that represents the count of overlapping polygons from Input Features.

• If the Group Field parameter is not specified, all input areas will be intersected and a single centroid created.

• Null values and empty string values in the Group Field parameter are ignored and not included in the analysis.

• Any area that is occupied by two or more features is considered an overlap. Features in a group are considered separately from features in other groups. Single features cannot overlap.

Syntax

arcpy.intelligence.FindOverlaps(in_features, out_intersection, out_centroid, {group_field})

Parameter	Explanation	Data Type
in_features	The input polygon features for which overlaps will be computed.	Feature Layer
out_intersection	The output intersection areas.	Feature Class
out_centroid	The output centroid locations of the Output Intersections features.	Feature Class
group_field (Optional)	The Input Features group field.	Field

Code sample

FindOverlaps example 1 (Python window)

The following Python window script demonstrates how to use the FindOverlaps function in immediate mode.

import arcpy

arcpy.FindOverlaps_intelligence("C:/data/input.gdb/areas", 
                                "C:/data/results.gdb/intersections",
                                "C:/data/results.gdb/centroids", 
                                "category")

FindOverlaps example 2 (stand-alone script)

The following Python script demonstrates how to use the FindOverlaps function in a stand-alone script.

# Name: FindOverlaps_Example2.py
# Description: Find overlaps/intersections of polygons.

# Import system modules
import arcpy

# Set local variables
in_features = "C:/data/input.gdb/areas" 
out_intersections = "C:/data/results.gdb/intersections"
out_centroids = "C:/data/results.gdb/centroids" 
group_field = "category"

# Execute FindOverlaps
arcpy.FindOverlaps_intelligence(in_features, out_intersections,
                                out_centroids, group_field)

Environments

This tool does not use any geoprocessing environments.

Licensing information

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