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

LabelExplanationData 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

LabelExplanationData 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

arcpy.cartography.AggregatePoints(in_features, out_feature_class, aggregation_distance)
NameExplanationData 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

NameExplanationData 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)

Licensing information

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

Related topics