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...

Expand

Available with Spatial Analyst license.

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

Summary

Expands specified zones of a raster by a specified number of cells.

Learn more about how Expand works

Illustration

Expand illustration
OutRas = Expand(InRas1, 1, [5])

Usage

  • The specified zone values are considered to be foreground zones, while the remaining zone values are considered to be background zones. With this tool the foreground zones are allowed to expand into the background zones.

  • When two foreground zones compete to expand into the same background zone, the conflict is resolved based on the value of the majority of surrounding cells.

  • NoData cells are always considered background cells; therefore, neighboring cells of any value can expand into NoData cells. NoData cells will never expand into their neighbors.

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

Syntax

Expand (in_raster, number_cells, zone_values)
ParameterExplanationData Type
in_raster

The input raster for which the identified zones are to be expanded

It must be of integer type.

Raster Layer
number_cells

The number of cells to expand each specified zone by.

The value must be an integer greater than 1.

Long
zone_values
[zone_value,...]

The list of zone values to expand.

The zone values must be integers. They can be in any order.

Long

Return Value

NameExplanationData Type
out_raster

The output generalized raster.

The specified zones of the input raster will be expanded by the specified number of cells.

The output is always of integer type.

Raster

Code Sample

Expand example 1 (Python window)

This example expands the zone specified by a list of values by two cells.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExpand = Expand("filter", 2, [0, 6, -3])
outExpand.save("C:/sapyexamples/output/outexpand.img")
Expand example 2 (stand-alone script)

This example expands the zone specified by a list of values by two cells.

# Name: Expand_Ex_02.py
# Description: Expands specified zones of a raster 
#              by a specified number of cells.
# 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 = "filter"
numberCells = 2
zoneValues = [0, 6, -3]

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

# Execute Expand
outExpand = Expand(inRaster, numberCells, zoneValues)

# Save the output 
outExpand.save("C:/sapyexamples/output/outexpand")

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
  • Shrink
  • Nibble
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