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.

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, the function will perform the operation on each band from one input, and the output will be a multiband raster. The number of bands in each multiband input must be the same.

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, and the output will be a multiband raster.

If both inputs are multidimensional rasters with same number of variables, the function will perform the operation for all slices with same dimension value, and the output will be a multidimensional raster. The variables in the inputs must have same dimensions or a common dimension but no uncommon dimensions.

If one of the inputs is a multidimensional raster and the other input is a constant, the function will perform the operation for all slices for all variables against the constant value, and the output will be a multidimensional raster.

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


In this topic
  1. Overview
  2. Notes
  3. Parameters