Cell Size (Environment setting)

Tools that honor the Cell Size environment set the output raster cell size, or resolution, for the operation. The default output resolution is determined by the coarsest of the input raster datasets.

Usage notes

  • To use a specific numeric cell size, type the value directly in the box.
  • The default output resolution is determined by the coarsest of the input raster datasets.
  • The default cell size when a feature dataset is used as input to a tool is the width or height (whichever is shorter) of the extent of the feature dataset, divided by 250.
  • If a numeric cell size value is specified, it will not be projected if the output is in a spatial reference other than that of the input data. In other cases, the input dataset will be projected and the new cell size will be used.
  • Exercise caution when specifying a cell size finer than the input raster datasets. No new data is created; cells are interpolated using nearest neighbor resampling. The result is only as precise as the coarsest input.
  • When datasets are projected during analysis, the output raster cell size will use the method specified in the Cell Size Projection Method environment setting.

Dialog syntax

  • Maximum of Inputs—Use the largest cell size of all input datasets. This is the default.
  • Minimum of Inputs—Use the smallest cell size of all input datasets.
  • Same as Layer <name>—Use the cell size of the specified layer or raster dataset.

Scripting syntax

arcpy.env.cellSize = cellsize_option

cellsize_optionExplanation

MAXOF

Maximum of inputs—Largest cell size of all input datasets. This is the default.

MINOF

Minimum of inputs—Smallest cell size of all input datasets.

number

Use the specified cell size value directly.

layer name

Use the cell size of the specified layer or raster dataset.

cellSize syntax

Script example

import arcpy

# Set the cell size environment using a keyword.
arcpy.env.cellSize = "MINOF"

# Set the cell size environment using a number.
arcpy.env.cellSize = 20

# Set the cell size environment using a raster dataset.
arcpy.env.cellSize = "C:/sapyexamples/data/myraster"