Summary
Creates polygon features around clusters of proximate point features.
Usage
Polygons are created around clusters of three or more points within the aggregation distance.
A one-to-many relationship table—named the same as the output feature class appended with _Tbl—will be created that links the aggregated polygons to their source point features. This table is in the same location as the output feature class and contains two fields, OUTPUT_FID and INPUT_FID, storing the aggregated feature IDs and their source feature IDs, respectively. The link can become incorrect when any of the input or output features are modified. With this table, you can derive necessary attributes for the output features from their source features using appropriate geoprocessing tools.
Point aggregation may introduce polygon holes or areas where adjacent polygon boundaries meet at one vertex.
Syntax
arcpy.cartography.AggregatePoints(in_features, out_feature_class, aggregation_distance)
Parameter | Explanation | Data Type |
in_features | The input point features that will be assessed for proximity and clustering. | Feature Layer |
out_feature_class | The feature class created to hold the polygons that represent the point clusters. | Feature Class |
aggregation_distance | The distance between points that will be clustered. | Linear Unit |
Derived Output
Name | Explanation | Data Type |
out_table | A one-to-many relationship table—named the same as the output feature class appended with _Tbl—will be created that links the aggregated polygons to their source point features. | Table |
Code sample
AggregatePoints example 1 (Python window)
The following Python Window script demonstrates how to use the AggregatePoints tool in immediate mode.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.AggregatePoints_cartography("C:/data/cartography.gdb/crime/robberies",
"C:/data/cartography.gdb/crime/clustered_robberies",
"100 meters")
AggregatePoints example 2 (stand-alone script)
This stand-alone script shows an example of using the AggregatePoints tool.
# Name: AggregatePoints_standalone_script.py
# Description: Creates polygon features around clusters of proximate point features.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
in_point_features = "C:/data/cartography.gdb/crime/robberies"
out_feature_class = "C:/data/cartography.gdb/crime/clustered_robberies"
aggregation_distance = "100 meters"
# Execute Aggregate Points
arcpy.AggregatePoints_cartography(in_point_features, out_feature_class, aggregation_distance)
Environments
Licensing information
- Basic: No
- Standard: No
- Advanced: Yes