Igual a (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Realiza una operación relacional de igualdad sobre dos entradas en una base de celda a celda.

Devuelve un 1 para las celdas donde el primer ráster es igual al segundo ráster y un 0 para las celdas donde no lo es.

Más información acerca de cómo funcionan las herramientas de matemática relacional

Ilustración

Ilustración de Igual que (relacional)
OutRas = EqualTo(InRas1, Const2Ras)

Uso

  • Se necesitan dos entradas para que ocurra esta evaluación relacional.

  • El orden de entradas no tiene importancia para esta herramienta.

  • 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 o una de las entradas es una constante, la salida será un ráster multibanda. El número de bandas de cada entrada multibanda debe ser el mismo.

  • La herramienta realiza la operación con cada banda de una entrada contra la banda correspondiente de la otra entrada. Si una de las entradas es un ráster multibanda y la otra es una constante, la herramienta realizará la operación contra el valor constante para cada banda de la entrada multibanda.

  • En Álgebra de mapas, el símbolo del operador equivalente para esta herramienta es "==" (vínculo).

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

EqualTo(in_raster_or_constant1, in_raster_or_constant2)
ParámetroExplicaciónTipo de datos
in_raster_or_constant1

La entrada con la que se comparará para la igualdad con la segunda entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
in_raster_or_constant2

La entrada desde la que se comparará para la igualdad con la primera entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Los valores de celda de salida serán 0 u 1 enteros; o NoData si cualquier valor de celda de entrada es NoData.

Raster

Muestra de código

Ejemplo 1 de EqualTo (ventana de Python)

Este ejemplo realiza una operación relacional de igualdad sobre dos rásteres Grid y genera el resultado como un ráster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEqualTo = EqualTo("degs", "negs")
outEqualTo.save("C:/sapyexamples/output/outequalto.tif")
Ejemplo 2 de EqualTo (script independiente)

Este ejemplo realiza una operación relacional de igualdad en dos rásteres Grid.

# Name: 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 = "degs"
inRaster2 = "negs"

# Execute EqualTo
outEqualTo = EqualTo(inRaster1, inRaster2)

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

Información de licenciamiento

  • Basic: Requiere Spatial Analyst o Image Analyst
  • Standard: Requiere Spatial Analyst o Image Analyst
  • Advanced: Requiere Spatial Analyst o Image Analyst

Temas relacionados