Booleana XOr (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Ejecuta una operación booleana Or exclusiva sobre los valores de celda de dos rásteres de entrada.

Si un valor de entrada es verdadero (distinto de cero) y el otro es falso (cero), la salida es 1. Si los dos valores de entrada son verdaderos o los dos son falsos, la salida es 0.

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

Ilustración

Ilustración de Booleana XOr
OutRas = BooleanXOr(InRas1, InRas2)

Uso

  • Las herramientas matemáticas booleanas interpretan las entradas como valores booleanos en los cuales los valores distintos de cero se consideran verdaderos y el cero se considera falso.

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

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

  • Si los valores de entrada son de punto flotante, se convierten en valores enteros de 0 ó 1 antes de que se realice la operación. Si el valor de entrada es un punto flotante 0.0, se convierte a un entero 0. Si la entrada es cualquier valor distinto de 0,0, se convierte para que sea un entero 1. Por ejemplo, los valores flotantes de entrada 0,6, 32,22 y -4,2 se tratarán como si fueran 1. 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, la herramienta 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, la herramienta realizará la operación con el valor constante de cada banda de la entrada multibanda, y la salida será un ráster multibanda.

  • Si ambas entradas son datos ráster multidimensionales con el mismo número de variables, la herramienta realizará la operación para todas las porciones con el mismo valor de dimensión. La salida será un ráster multidimensional en formato CRF. Las variables de las entradas deben tener al menos una dimensión común y un valor dimensional común para que esta herramienta procese; de lo contrario, se producirá un error.

    Si ambas entradas tienen una variable pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (definido como arcpy.env.matchMultidimensionalVariable = False en Python) antes de ejecutar la herramienta.

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

  • 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada o valor constante 1

La primera entrada que se utiliza en esta operación booleana.

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
Ráster de entrada o valor constante 2

La segunda entrada que se utiliza en esta operación booleana.

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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Los valores de celda de la salida serán 0 o 1.

Raster

BooleanXOr(in_raster_or_constant1, in_raster_or_constant2)
NombreExplicaciónTipo de datos
in_raster_or_constant1

La primera entrada que se utiliza en esta operación booleana.

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 segunda entrada que se utiliza en esta operación booleana.

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 la salida serán 0 o 1.

Raster

Muestra de código

Ejemplo 1 de Booleana Xor (ventana de Python)

Este ejemplo ejecuta una operación booleana XOr sobre dos cuadrículas ráster y genera un ráster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBooleanXOr = BooleanXOr("degs", "negs")
outBooleanXOr.save("C:/sapyexamples/output/outboolxor.tif")
Ejemplo 2 de Booleana Xor (script independiente)

Este ejemplo realiza una operación booleana XOr en dos cuadrículas ráster.

# Name: BooleanXOr_Ex_02.py
# Description: Performs a Boolean Exclusive Or operation on the
#              cell values of two input rasters
# 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 BooleanXOr
outBooleanXOr = BooleanXOr(inRaster1, inRaster2)

# Save the output 
outBooleanXOr.save("C:/sapyexamples/output/outboolxor")

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