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.

Parameters

LabelExplanationData Type
Input Features

The input polygon features for which overlaps will be computed.

Feature Layer
Output Intersections

The output intersection areas.

Feature Class
Output Centroids

The output centroid locations of the Output Intersections features.

Feature Class
Group Field
(Optional)

The Input Features group field.

Field

arcpy.intelligence.FindOverlaps(in_features, out_intersection, out_centroid, {group_field})
NameExplanationData 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 out_intersection features.

Feature Class
group_field
(Optional)

The in_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.intelligence.FindOverlaps("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"

# Run FindOverlaps
arcpy.intelligence.FindOverlaps(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

Related topics