EqualToFrequency

Summary

Creates a raster object where each pixel contains the number of times the values in a set of rasters are equal to another raster.

Discussion

For more information about how this function works, see the Equal To Frequency tool.

The referenced raster dataset for the raster object is temporary. To make it permanent, you can call the raster object's save method.

Syntax

EqualToFrequency (value_raster, rasters, {extent_type}, {cellsize_type}, {process_as_multiband})

Parameter	Explanation	Data Type
value_raster	A value raster that will be referenced by the set of input rasters.	Raster
rasters [rasters,...]	The list of input rasters.	Raster
extent_type	The method that will be used to compute the extent of the output when the input rasters have different extents. FirstOf—The output extent is defined using the extent of the first input raster. LastOf—The output extent is defined using the extent of the last input raster. IntersectionOf—The output extent is defined as the intersecting area of the input rasters. UnionOf—The output extent is defined as the total extent of the input rasters. (The default value is FirstOf)	String
cellsize_type	The method that will be used to compute the pixel size of the output when the input rasters have different pixel sizes. FirstOf—The output pixel size is defined using the pixel size of the first input raster. LastOf—The output pixel size is defined using the pixel size of the last input raster. MaxOf—The output pixel size is defined using the maximum pixel size of the input rasters. MeanOf—The output pixel size is defined using the mean of both input rasters. MinOf—The output pixel size is defined using the minimum pixel size of the input rasters. (The default value is FirstOf)	String
process_as_multiband	Specifies how the bands of the input rasters are processed. True—Each multiband raster will be processed as a multiband raster. The operation will be performed for each band from one input using the corresponding band number from other inputs. False—Each band from a multiband raster input will be processed separately as a single-band raster. (The default value is False)	Boolean

Return Value

Data Type	Explanation
Raster	The output raster.

Code sample

EqualToFrequency example

Calculates the number of times the values in the input rasters are equal to a value raster.

# Import system modules
import arcpy
from arcpy.ia import *

#Set the local variables
value_raster = r"c:\temp\value_raster.tif"

rasters = [r"c:\temp\raster1.tif", r"c:\temp\raster2.tif", r"c:\temp\raster3.tif"] 

#Execute
EqualTo_raster = EqualToFrequency(value_raster, rasters, "UnionOf", "FirstOf", True)