== (Equal To) (arcpy.sa)

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 utiliza un operador con una entrada ráster, el resultado será un ráster. Sin embargo, si todas las entradas son números, entonces el resultado es un número.

Cuando se utilizan varios operadores en una expresión, no necesariamente se ejecutan en orden de izquierda a derecha. El operador con el valor de jerarquía más alta se ejecutará primero. Para obtener más información sobre la jerarquía del operador, consulte la tabla jerarquía del operador. Puede utilizar paréntesis para controlar el orden de ejecución.

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

Cuando varios operadores relacionales o booleanos se utilizan consecutivamente en una expresión simple, en algunos casos no se podrá ejecutar. Para evitar este posible problema, utilice los paréntesis apropiados en la expresión, de manera que el orden de ejecución de los operadores esté explícitamente definido. Para obtener más información, consulte Reglas de declaraciones complejas.

Se necesitan dos entradas para realizar la evaluación.

El orden de entrada no es importante para este operador.

Los valores de salida siempre son enteros.

Sintaxis

in_raster_or_constant1 == in_raster_or_constant2
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

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El objeto ráster de salida.

Where cell values in the first input are equal to that of the second input, the output cell value will be 1. If the values are not equal, the output value will be 0.

Raster

Ejemplo 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")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute EqualTo
outEqualTo = inRaster1 == inRaster2

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

Entornos

Temas relacionados

9/12/2013