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

Available with Spatial Analyst license.

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

Summary

Generates a reduced-resolution version of a raster. Each output cell contains the Sum, Minimum, Maximum, Mean, or Median of the input cells that are encompassed by the extent of that cell.

Learn more about how Aggregate works

Illustration

Aggregate illustration
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

Usage

  • If the values of the input raster are integer and any statistics type option other than Mean is used, the output raster will be integer. If the values of the input raster are floating point or the statistics type is Mean, the output raster will be floating point.

  • The geoprocessing analysis environments Extent and Cell size are recognized by this tool. To determine the output raster's resolution when an integer cell size has been specified, multiply the cell resolution of the analysis environment by the input cell factor parameter. If the cell size for the analysis environment is set to the minimum or maximum of the inputs, the resolution of the output raster will be the product of the input raster's resolution multiplied by the specified cell factor.

  • See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.

Syntax

Aggregate (in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
ParameterExplanationData Type
in_raster

The input raster to aggregate.

It can be of integer or floating point type.

Raster Layer
cell_factor

The factor by which to multiply the cell size of the input raster to obtain the desired resolution for the output raster.

For example, a cell factor value of three would result in an output cell size three times larger than that of the input raster.

The value must be an integer greater than 1.

Long
aggregation_type
(Optional)

Establishes how the value for each output cell will be determined.

The values of the input cells encompassed by the coarser output cell are aggregated by one of the following statistics:

  • SUM —The sum (total) of the input cell values. This is the default.
  • MAXIMUM — The largest value of the input cells.
  • MEAN — The average value of the input cells.
  • MEDIAN — The median value of the input cells.
  • MINIMUM — The smallest value of the input cells.
String
extent_handling
(Optional)

Defines how to handle the boundaries of the input raster when its rows or columns are not a multiple of the cell factor.

  • EXPAND — Expands the bottom or right boundaries of the input raster so the total number of cells in a row or column is a multiple of the cell factor. Expanded cells are given a value of NoData.With this option, the output raster can cover a larger spatial extent than the input raster. This is the default. This is the default.
  • TRUNCATE — Reduces the number of rows or columns in the output raster by 1. This will truncate the remaining cells on the bottom or right boundaries of the input raster, making the number of rows or columns in the input raster a multiple of the cell factor.With this option, the output raster can cover a smaller spatial extent than the input raster.

If the number of rows and columns in the input raster is a multiple of the cell_factor, these keywords are not used.

Boolean
ignore_nodata
(Optional)

Denotes whether NoData values are ignored by the aggregation calculation.

  • DATA — Specifies that if NoData values exist for any of the cells that fall within the spatial extent of a larger cell on the output raster, the NoData values will be ignored when determining the value for output cell locations. Only input cells within the extent of the output cell that have data values will be used in determining the value of the output cell. This is the default.
  • NODATA — Specifies that if any cell that falls within the spatial extent of a larger cell on the output raster has a value of NoData, the value for that output cell location will be NoData.When the this option is used, it is implied that when cells within an aggregation contain the NoData value, there is insufficient information to perform the specified calculations necessary to determine an output value.
Boolean

Return Value

NameExplanationData Type
out_raster

The output aggregated raster.

It is a reduced-resolution version of the input raster.

Raster

Code Sample

Aggregate example 1 (Python window)

This example aggregates a raster by averaging the values with a cell factor of 3 and outputs a TIFF raster.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAggreg = Aggregate("highres", 3, "MAXIMUM", "TRUNCATE", "DATA")
outAggreg.save("C:/sapyexamples/output/aggregate.tif")
Aggregate example 2 (stand-alone script)

This example aggregates a raster by averaging the values with a cell factor of 3 and outputs a Grid raster.

# Name: Aggregate_Ex_02.py
# Description: Generates a reduced resolution version of a raster.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set local variables
inRaster = "highres"
cellFactor = 3

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")

# Save the output 
outAggreg.save("C:/sapyexamples/output/aggregate02")

Environments

  • Auto Commit
  • Cell Size
  • Compression
  • Current Workspace
  • Extent
  • Geographic Transformations
  • Mask
  • Output CONFIG Keyword
  • Output Coordinate System
  • Raster Statistics
  • Scratch Workspace
  • Snap Raster
  • Tile Size

Licensing Information

  • ArcGIS for Desktop Basic: Requires Spatial Analyst
  • ArcGIS for Desktop Standard: Requires Spatial Analyst
  • ArcGIS for Desktop Advanced: Requires Spatial Analyst

Related Topics

  • An overview of the Generalization toolset
  • Altering the resolution of a raster
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