Disponible con una licencia de Spatial Analyst.
Resumen
Ejecuta una evaluación booleana del ráster de entrada con una expresión lógica.
Cuando la expresión se evalúa como verdadera, el valor de celda de salida es 1. Si la expresión es falsa, el valor de celda de salida es 0.
Ilustración
Uso
La prueba se especifica mediante 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 en el Generador de consultas:
Para usar una {where_clause} en Python, se debe encerrar entre comillas. Por ejemplo, "Valor > 5000".
Puede consultar la ayuda para obtener más información sobre especificar una consulta en Python.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
Test (in_raster, where_clause)
| Parámetro | 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 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 salida serán 0 ó 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 (secuencia de comandos 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Test
outTest = Test(inRaster, inWhereClause)
# Save the output
outTest.save("C:/sapyexamples/output/outtest")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Análisis espacial
- ArcGIS Desktop Standard: Requiere Análisis espacial
- ArcGIS Desktop Advanced: Requiere Análisis espacial