Label | Explanation | Data 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 |
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
arcpy.intelligence.FindOverlaps(in_features, out_intersection, out_centroid, {group_field})
Name | 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 out_intersection features. | Feature Class |
group_field (Optional) | The in_features group field. | Field |
Code sample
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")
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
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes