== (Relational Equal To) operator

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Performs a relational equal-to operation on two inputs on a cell-by-cell basis within the Analysis window.

Ilustración

Equal To (Relational) operator illustration
OutRas = Raster("InRas1") == Raster("Const2Ras")

Debate

Returns 1 for cells where the first raster equals the second raster and 0 for cells where it does not.

Cuando se utilice un operador con una entrada de ráster, el resultado será un ráster. Sin embargo, si todas las entradas son números, el resultado es un número.

Cuando se utilizan varios operadores en una expresión, no necesariamente se ejecutan por orden de izquierda a derecha. El operador con el valor de jerarquía más alto será el que se ejecute primero. Para obtener más información, consulte la tabla de jerarquía del operador en Trabajar con operadores en Álgebra de mapas. Puede utilizar paréntesis para controlar el orden de ejecución.

Los operadores booleanos (~, &, ^, |) tienen un nivel más alto en la jerarquía que los operadores relacionales (<, <=, >, >=, ==, !=). Por consiguiente, los operadores booleanos se utilizan en la misma expresión que los operadores relacionales, pero los booleanos se ejecutan primero. Para cambiar el orden de la ejecución, utilice paréntesis.

Cuando se utilizan varios operadores booleanos y/o relacionales en una sola expresión, en algunos casos puede producirse un error de ejecución. Para evitar este posible problema, utilice paréntesis adecuados en la expresión para definir de manera explícita el orden de ejecución de los operadores. Para obtener más información, consulte la sección de reglas de sentencias complejas de Crear sentencias complejas.

Se necesitan dos entradas para realizar la evaluación.

El orden de la entrada es irrelevante para este operador.

Los valores de salida siempre son enteros.

Si ambas entradas son rásteres de banda única o una de las entradas es una constante, la salida será un ráster de banda única.

Si ambas entradas son rásteres multibanda, el operador realizará la operación en cada banda desde una entrada y la salida será un ráster multibanda. El número de bandas en cada entrada multibanda debe ser el mismo.

Si una de las entradas es un ráster multibanda y la otra entrada es una constante, el operador realizará la operación con respecto al valor constante de cada banda de la entrada multibanda, y la salida será un ráster multibanda.

Si ambas entradas son rásteres multidimensionales con el mismo número de variables, el operador realizará la operación para todas las porciones con el mismo valor de dimensión y la salida será un ráster multidimensional. Las variables en las entradas deben tener las mismas dimensiones o dimensión común, pero no dimensiones inusuales.

Si ambas entradas tienen una variable pero nombres diferentes, establezca el entorno de geoprocesamiento matchMultidimensionalVariable en False para realizar la operación.

Si una de las entradas es un ráster multidimensional y la otra entrada es una constante, el operador realizará la operación en todas las porciones de todas las variables respecto al valor constante y la salida será un ráster multidimensional.

Parámetros

OperandoExplicaciónTipo de datos
in_raster_or_constant1

The input that will be compared to for equality by the second input.

Si una de las entradas es un ráster y la otra es un escalar, se crea un ráster de salida con la evaluación que realiza cada celda en el ráster de entrada.

Raster Layer | Constant
in_raster_or_constant2

The input that will be compared from for equality by the first input.

Si una de las entradas es un ráster y la otra es un escalar, se crea un ráster de salida con la evaluación que realiza cada celda en el ráster de entrada.

Raster Layer | Constant

Muestra de código

== (Equal To) example 1 (Python window)

This sample performs an Equal To operation on two input rasters.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEqualTo = Raster("degs") == Raster("negs")
outEqualTo.save("C:/sapyexamples/output/outequalto.tif")
== (Equal To) example 2 (stand-alone script)

This sample performs an Equal To operation on two input rasters.

# Name: Op_EqualTo_Ex_02.py
# Description: Performs a relational equal-to operation on two inputs
#              on a cell-by-cell basis within the Analysis window
# 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
inRaster1 = Raster("degs")
inRaster2 = Raster("negs")

# Execute EqualTo
outEqualTo = inRaster1 == inRaster2

# Save the output 
outEqualTo.save("C:/sapyexamples/output/outequalto")

Temas relacionados