Equal To function

Available with Image Analyst license.

Available with Spatial Analyst license.

Overview

Performs an equal-to operation on two rasters on a pixel-by-pixel basis.

Returns the value 1 for pixels where the first raster equals the second raster and value 0 for pixels where they are not equal.

Learn more about how the Relational math tools work

Equal To (Relational) illustration

Notes

Two inputs are necessary for this function to execute.

The order of the inputs is irrelevant for this function.

If both inputs are single band rasters, or one of the inputs is a constant, the output will be a single band raster.

If both inputs are multiband rasters, or one of the inputs is a constant, the output will be a multiband raster. The number of bands in each multiband input must be the same.

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

Parameters

Parameter nameDescription

Raster

The input that will be used for comparison for equality by the second input.

A constant value can be used as an input for this parameter, provided a raster is specified for the other parameter.

Raster2

The input that will be used for comparison for equality by the first input.

A constant value can be used as an input for this parameter, provided a raster is specified for the other parameter.

Extent Type

Choose which extent should be used in the output raster:

  • First Of—Use the extent of the first input raster to determine the processing extent.

  • Intersection Of—Use the extent of the overlapping pixels to determine the processing extent. This is the default.
  • Union Of—Use the extent of all the rasters to determine the processing extent.
  • Last Of—Use the extent of the last input raster to determine the processing extent.

Cellsize Type

Choose which cell size to use in the output raster. If all the input cell sizes are the same, all the options will yield the same results.

  • First Of—Use the first cell size of the input rasters.
  • Min Of—Use the smallest cell size of all the input rasters.
  • Max Of—Use the largest cell size of all the input rasters. This is the default.
  • Mean Of—Use the mean cell size of all the input rasters.
  • Last Of—Use the last cell size of the input rasters.

Related topics