ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Aggregate Points

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

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

AggregatePoints_cartography (in_features, out_feature_class, aggregation_distance)
ParameterExplanationData 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

Code Sample

AggregatePoints tool Example (Python Window)

The following Python Window script demonstrates how to use the AggregatePoints tool in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.AggregatePoints_cartography("C:/data/cartography.gdb/crime/robberies",
                                  "C:/data/cartography.gdb/crime/clustered_robberies", "100 meters")
AggregatePoints tool Example (stand-alone Python 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

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

Licensing Information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: No
  • ArcGIS for Desktop Advanced: Yes

Related Topics

  • An overview of the Generalization toolset
  • Understanding conflict resolution and generalization
  • Automating conflict resolution and generalization workflows with geoprocessing
  • Aggregate Polygons
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal