Cell Statistics (Image Analyst)

Summary

Calculates a per-cell statistic from multiple rasters.

The available statistics are Majority, Maximum, Mean, Median, Minimum, Minority, Percentile, Range, Standard deviation, Sum, and Variety.

Learn more about how Cell Statistics works

Illustration

Example Cell Statistics tool input and output values
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

Usage

  • The order of the input rasters is irrelevant for this tool.

  • For the Maximum, Minimum, Mean, Median, Majority, Minority, Percentile, and Sum statistic types, if a single raster is used as the input, the output cell values will be the same as the input cell values. For Range and Standard deviation, the output cell values will all be 0. For Variety, it will be 1.

  • If the Process as multiband parameter is unchecked (process_as_multiband is set to SINGLE_BAND in Python), each band from a multiband raster input will be processed separately as a single band raster, and the output will be a single band raster.

    Single-band output when processed as SINGLE_BAND
    The Cell Statistics tool creates a single-band output when processed as SINGLE_BAND.
  • If the Process as multiband parameter is checked (process_as_multiband is set to MULTI_BAND in Python), each multiband raster input will be processed as a multiband raster, and the output will be a multiband raster. The output raster will also be multiband if the inputs are a combination of a multiband raster and constants. The number of bands in each multiband input must be the same.

    The tool will perform the operation on each band from one input using the corresponding band from the other input. If one of the inputs is a multiband raster and the other input is a constant, the tool will perform the operation using the constant value for each band in the multiband input.

    Multiband output when processed as MULTI_BAND.
    The Cell Statistics tool creates a multiband output when processed as MULTI_BAND.
  • If all inputs are multidimensional raster data with the same number of variables, the tool will perform the operation for all slices with the same dimension value. The output will be a multidimensional raster in CRF format. The variables in the inputs must have at least one common dimension and one common dimensional value for this tool to process, otherwise an error will occur.

    If all of the inputs have one variable but different names, uncheck the Match Multidimensional Variable geoprocessing environment (set arcpy.env.matchMultidimensionalVariable = False in Python) before performing the operation.

    If one or more of the inputs are multidimensional rasters and the other inputs are constant, the tool will perform the operation for all slices for all variables using the constant value, and the output will be a multidimensional raster.

  • For majority and minority calculations, when there is a tie, the output will be the lowest of the tied values.

Parameters

LabelExplanationData Type
Input rasters or constant values

A list of input rasters for which a statistical operation will be calculated for each cell in the analysis window.

A number can be used as an input; however, the cell size and extent must first be set in the environment.

If the Process as multiband parameter is checked, all multiband inputs must have an equal number of bands.

Raster Layer; Constant
Overlay statistic
(Optional)

Specifies the statistic type to be calculated.

The default statistic type is Mean.

  • MeanThe mean (average) of the inputs will be calculated. This is the default.
  • MajorityThe majority (value that occurs most often) of the inputs will be determined.
  • MaximumThe maximum (largest value) of the inputs will be determined.
  • MedianThe median of the inputs will be calculated.
  • MinimumThe minimum (smallest value) of the inputs will be determined.
  • MinorityThe minority (value that occurs least often) of the inputs will be determined.
  • PercentileThe percentile of the inputs will be calculated. The 90th percentile is calculated by default. You can specify other values (from 0 to 100) using the Percentile value parameter.
  • RangeThe range (difference between largest and smallest value) of the inputs will be calculated.
  • Standard deviationThe standard deviation of the inputs will be calculated.
  • SumThe sum (total of all values) of the inputs will be calculated.
  • VarietyThe variety (number of unique values) of the inputs will be calculated.
String
Ignore NoData in calculations
(Optional)

Specifies whether NoData values will be ignored by the statistic calculation.

  • Checked—At the processing cell location, if any of the input rasters has NoData, that NoData value will be ignored. The statistics will be computed by only considering the cells with valid data. This is the default.
  • Unchecked—If the processing cell location for any of the input rasters is NoData, the output for that cell will be NoData.
Boolean
Process as multiband
(Optional)

Specifies how the input multiband raster bands will be processed.

  • Unchecked—Each band from a multiband raster input will be processed separately as a single band raster. This is the default.
  • Checked—Each multiband raster input will be processed as a multiband raster. The operation will be performed for each band from one input using the corresponding band number from the other inputs.
Boolean
Percentile value
(Optional)

The percentile value that will be calculated. The default is 90, indicating the 90th percentile.

The value can range from 0 to 100. The 0th percentile is essentially equivalent to the minimum statistic, and the 100th percentile is equivalent to the maximum statistic. A value of 50 will produce essentially the same result as the median statistic.

This parameter is only available if the Overlay statistic parameter is set to Percentile.

Double
Percentile interpolation type
(Optional)

Specifies the method of interpolation that will be used when the specified percentile value is between two input cell values.

  • Auto-detectIf the input rasters are of integer pixel type, the Nearest method will be used. If the input rasters are of floating point pixel type, the Linear method will be used. This is the default.
  • NearestThe nearest available value to the desired percentile will be used. In this case, the output pixel type will be the same as that of the input rasters.
  • LinearThe weighted average of the two surrounding values from the percentile will be used. In this case, the output pixel type will be floating point.
String

Return Value

LabelExplanationData Type
Output raster

The output raster.

For each cell, the value is determined by applying the specified statistic type to the input rasters at that location.

Raster

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})
NameExplanationData Type
in_rasters_or_constants
[in_raster_or_constant,...]

A list of input rasters for which a statistical operation will be calculated for each cell in the analysis window.

A number can be used as an input; however, the cell size and extent must first be set in the environment.

If the processing_as_multiband parameter is set to MULTI_BAND, all multiband inputs should have an equal number of bands.

Raster Layer; Constant
statistics_type
(Optional)

Specifies the statistic type to be calculated.

  • MEANThe mean (average) of the inputs will be calculated. This is the default.
  • MAJORITYThe majority (value that occurs most often) of the inputs will be determined.
  • MAXIMUMThe maximum (largest value) of the inputs will be determined.
  • MEDIANThe median of the inputs will be calculated.
  • MINIMUMThe minimum (smallest value) of the inputs will be determined.
  • MINORITYThe minority (value that occurs least often) of the inputs will be determined.
  • PERCENTILEThe percentile of the inputs will be calculated. The 90th percentile is calculated by default. You can specify other values (from 0 to 100) using the percentile_value parameter.
  • RANGEThe range (difference between largest and smallest value) of the inputs will be calculated.
  • STDThe standard deviation of the inputs will be calculated.
  • SUMThe sum (total of all values) of the inputs will be calculated.
  • VARIETYThe variety (number of unique values) of the inputs will be calculated.

The default statistic type is MEAN.

String
ignore_nodata
(Optional)

Specifies whether NoData values will be ignored by the statistic calculation.

  • DATAAt the processing cell location, if any of the input rasters has NoData, that NoData value will be ignored. The statistics will be computed by only considering the cells with valid data. This is the default.
  • NODATAIf the processing cell location for any of the input rasters is NoData, the output for that cell will be NoData.
Boolean
process_as_multiband
(Optional)

Specifies how the input multiband raster bands will be processed.

  • SINGLE_BANDEach band from a multiband raster input will be processed separately as a single band raster. This is the default.
  • MULTI_BANDEach multiband raster input will be processed as a multiband raster. The operation will be performed for each band from one input using the corresponding band number from the other inputs.
Boolean
percentile_value
(Optional)

The percentile value that will be calculated. The default is 90, indicating the 90th percentile.

The value can range from 0 to 100. The 0th percentile is essentially equivalent to the minimum statistic, and the 100th percentile is equivalent to the maximum statistic. A value of 50 will produce essentially the same result as the median statistic.

This parameter is only supported if the statistics_type parameter is set to PERCENTILE.

Double
percentile_interpolation_type
(Optional)

Specifies the method of interpolation that will be used when the specified percentile value is between two input cell values.

  • AUTO_DETECTIf the input rasters are of integer pixel type, the NEAREST method will be used. If the input rasters are of floating point pixel type, the LINEAR method will be used. This is the default.
  • NEARESTThe nearest available value to the desired percentile will be used. In this case, the output pixel type will be the same as that of the input rasters.
  • LINEARThe weighted average of the two surrounding values from the percentile will be used. In this case, the output pixel type will be floating point.
String

Return Value

NameExplanationData Type
out_raster

The output raster.

For each cell, the value is determined by applying the specified statistic type to the input rasters at that location.

Raster

Code sample

CellStatistics example 1 (Python window)

This example calculates the standard deviation per cell on several input Grid rasters and outputs the result as an IMG raster.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")
CellStatistics example 2 (stand-alone script)

This example calculates the range per cell per band on several input multiband rasters and creates a multiband output raster.

# Name: CellStatistics_Ex_02.py
# Description: Calculates a per-cell statistic from multiple rasters
# 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
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "cost"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats")

Related topics