ArcGIS Desktop

  • Documentation
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

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
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

Aggregate Polygons

  • Summary
  • Illustration
  • Usage
  • Syntax
  • Code sample
  • Environments
  • Licensing information

Summary

Combines disjoint and adjacent polygons into new area features based on a distance.

Learn more about how Aggregate Polygons works

Illustration

Aggregate Polygons illustration

Usage

    License:

    This tool involves GRID functions and requires the ArcGIS Spatial Analyst extension software license.

  • The Input Coverage must have a polygon topology.

  • Due to the possibility of creating overlapping boundaries, preliminary regions are used as the resulting features. To create fully built regions from the preliminary regions, use the Clean tool with the POLY option on the Output Coverage.

  • The output coverage will not contain any attributes from the input coverage but will have a one-to-many relationship table, output_coverage.RXP (an INFO file), that links the aggregated preliminary regions to their source polygons. The .RXP extension stands for regions (output) cross-referencing polygons (input). This table will contain two items: output_coverage# and input_coverage#. With this link, you can derive attributes for the output features. The link can become incorrect when using the Clean tool to obtain region topology with a large fuzzy tolerance that causes small regions to collapse and disappear; the output_coverage# numbers will be reordered and not match the .RXP table.

Syntax

AggregatePolygons_arc (in_cover, out_cover, cell_size, distance, {orthogonal_option})
ParameterExplanationData Type
in_cover

The coverage containing polygons to be aggregated.

Coverage
out_cover

The output coverage containing aggregated features as preliminary regions with a subclass AREAAGG. The output coverage name must be different from the input coverage name.

Coverage
cell_size

Sets cell size in coverage units for grid conversion. Cell size must be greater than 0.

Double
distance

Sets the aggregation distance in coverage units. A distance must be equal to or greater than the cell size.

Double
orthogonal_option
(Optional)

Specifies the characteristic of the input features that will be preserved when constructing the aggregated boundaries.

  • NON_ORTHOGONAL —Specifies natural features, such as vegetation or soil polygons, which unlikely contain orthogonal shapes. This is the default.
  • ORTHOGONAL —Specifies building-like features for which orthogonal shapes will be preserved and constructed.
Boolean

Code sample

AggregatePolygons example (stand-alone script)

The following stand-alone script demonstrates how to use the AggregatePolygons tool.

# Name: AggregatePolygons_Example.py
# Description: Aggregates city limits polygons into a county boundary
# Requirements: ArcInfo Workstation

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCover = "citylim"
outCover = "c:/output/countybnd"
cellSize = 10
distance = 150
orthogonalOption = "NON_ORTHOGONAL"

# Execute AggregatePolygons
arcpy.AggregatePolygons_arc(inCover, outCover, cellSize, distance, 
                            orthogonalOption)

Environments

  • Current Workspace
  • Level Of Comparison Between Projection Files
  • Precision For Derived Coverages
  • Precision For New Coverages
  • Scratch Workspace

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: No
  • ArcGIS Desktop Advanced: Requires ArcInfo Workstation installed

Related topics

  • An overview of the coverage Generalization toolset
  • Aggregate Polygons
  • Dissolve

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS Platform

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

About Esri

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