Probar (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Ejecuta una evaluación booleana del ráster de entrada con una expresión lógica.

Cuando la expresión da resultado true, el valor de celda es 1. Si la expresión es false, el valor de la celda de salida es 0.

Ilustración

OutRas = Test(InRas1,"Value >= 2")

Uso

• La prueba viene especificada por una expresión SQL en la cláusula Where.

• En la cláusula Where se utiliza una consulta SQL. Consulte los temas siguientes para obtener más información sobre cómo se construyen consultas:

  • Construir consulta SQL
  • Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS

• Para usar una {where_clause} en Python, debe estar entre comillas. Por ejemplo, "Valor > 5000".

  Puede consultar la ayuda para obtener más información sobre especificar una consulta en Python.

• Si esta entrada es un ráster multibanda, la salida será un ráster multibanda. La herramienta realiza la operación con cada banda de la entrada.

• En ArcPy, si la entrada es un ráster multidimensional, se procesarán todas las porciones de todas las variables y la salida será un ráster multidimensional.

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	El ráster de entrada sobre el cual se ejecuta la evaluación booleana, basada en una expresión lógica.	Raster Layer
Cláusula WHERE	La expresión lógica que determinará qué celdas de entrada devolverán un valor de verdadero (1) y cuáles serán falsas (0). La cláusula Where sigue la forma general de una expresión SQL. Se puede introducir directamente, por ejemplo, VALUE > 100, si hace clic en el botón de moto Editar SQL . Si se encuentra en el modo de edición de Cláusula , puede empezar a construir la expresión haciendo clic en el botón Agregar modo Cláusula.	SQL Expression

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida. Los valores de celda de la salida serán 0 o 1.	Raster

Python

Test(in_raster, where_clause)

Nombre	Explicación	Tipo de datos
in_raster	El ráster de entrada sobre el cual se ejecuta la evaluación booleana, basada en una expresión lógica.	Raster Layer
where_clause	La expresión lógica que determinará qué celdas de entrada devolverán un valor de verdadero (1) y cuáles serán falsas (0). La expresión sigue la forma general de una expresión SQL. Un ejemplo de una where_clause es "VALUE > 100".	SQL Expression

Valor de retorno

Nombre	Explicación	Tipo 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 Prueba (ventana de Python)

Este ejemplo utiliza una cláusula WHERE para llevar a cabo una operación booleana en un ráster de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTest = Test("degs", "VALUE > 100")
outTest.save("C:/sapyexamples/output/outest.img")

Ejemplo 2 de Prueba (script independiente)

Este ejemplo utiliza una cláusula WHERE para llevar a cabo una operación booleana en un ráster de entrada.

# Name: Test_Ex_02.py
# Description: Perform a Boolean evaluation of the input raster based
#              on a where clause
# 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
inRaster = "degs"
inWhereClause = "VALUE > 100"

# Execute Test
outTest = Test(inRaster, inWhereClause)

# Save the output 
outTest.save("C:/sapyexamples/output/outtest")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Casos especiales

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