Aggregate Points (Cartography)

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.

Parameters

Dialog

Label	Explanation	Data Type
Input Features	The input point features that will be assessed for proximity and clustering.	Feature Layer
Output 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

Label	Explanation	Data Type
Relationship 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

Python

arcpy.cartography.AggregatePoints(in_features, out_feature_class, aggregation_distance)

Name	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.cartography.AggregatePoints("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.cartography.AggregatePoints(in_point_features, out_feature_class, aggregation_distance)

Environments

XY Resolution, Default Output Z Value, Output has Z values, Extent

Licensing information

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