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

Ilustración de Prueba
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:

  • 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

EtiquetaExplicaciónTipo 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 Consulta SQL. Si se encuentra en el modo de edición de Cláusula Editar cláusula, puede empezar a construir la expresión haciendo clic en el botón Agregar modo Cláusula.

SQL Expression

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

Test(in_raster, where_clause)
NombreExplicaciónTipo 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

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

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