InList (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Determina qué valores de la primera entrada se incluyen en un conjunto de otras entradas, a través de cada celda individual.

Para cada celda, si el valor del primer ráster de entrada se encuentra en alguna de las listas de las otras entradas, ese valor se asignará al ráster de salida. Si no se encuentra, la celda de salida será NoData.

Ilustración

Ilustración de InList
OutRas = InList(InRas1,[0, 2, 3, 7])

Uso

  • Si todas las entradas son enteros, el ráster de salida será un entero. Si alguna de las entradas es un punto flotante, la salida será un punto flotante.

  • En la lista de rásteres de entrada, el orden no es importante para el resultado de esta herramienta.

  • Si el parámetro Procesar como multibanda está desactivado (process_as_multiband se configura en SINGLE_BAND en Python), solo se utiliza la primera banda de un ráster de entrada o valor constante (input_raster_or_constant en Python) multibanda. Cada banda de rásteres de entrada o valores constantes multibanda (in_rasters_or_constants en Python) se procesará por separado como un ráster de una única banda.

  • Si el parámetro Procesar como multibanda está activado (process_as_multiband tiene el valor MULTI_BAND en Python), cada entrada de ráster multibanda se procesa como un ráster multibanda.

    El número de bandas de la salida depende del parámetro Ráster de entrada o valor constante. Si el ráster de entrada es una banda única o una constante, el número de bandas del ráster de salida coincidirá con el número máximo de bandas de todos los rásteres multibanda de los rásteres de entrada o valores contantes. Si el ráster de entrada es multibanda, el ráster de salida tendrá el mismo número de bandas que el ráster de entrada.

    Si cualquiera de los rásteres de entrada o valores constantes es un ráster con un número menor de bandas que el ráster de salida, las bandas que faltan se interpretarán como una banda con NoData. Si cualquiera de las entradas de la lista de entradas es una constante, se interpretará como un ráster multibanda en el que los valores de celda de todas las bandas coinciden con la constante y tienen el mismo número de bandas que el ráster de salida.

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

Sintaxis

InList(in_raster_or_constant, in_raster_or_constants, {process_as_multiband})
ParámetroExplicaciónTipo de datos
in_raster_or_constant

Entrada que define el valor que se buscará en la lista de rásteres celda por celda.

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_constants
[in_raster_or_constant,...]

Lista de rásteres de entrada con arreglo a la cual se evaluará la primera entrada. Para cada ubicación, si el valor de celda de la primera entrada existe en cualquier otro ráster, ese valor se asignará al ráster de salida. Si el valor no existe en ninguno de los demás rásteres, el valor de salida en esa ubicación será NoData.

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
process_as_multiband
(Opcional)

Especifica cómo se procesarán las bandas de ráster multibanda de entrada.

  • SINGLE_BANDCada banda de una entrada de ráster multibanda se procesará por separado como un ráster de una única banda. Esta es la opción predeterminada.
  • MULTI_BANDCada entrada de ráster multibanda se procesará como un ráster multibanda. La operación se realizará en cada banda a partir de una entrada mediante el uso del número de banda correspondiente de otras entradas.
Boolean

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Raster

Muestra de código

Ejemplo 1 de InList (ventana de Python)

En este ejemplo se calculan los valores de celda de la primera entrada se encuentran en el conjunto de otros rásteres de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outInList = InList("redlandsc1", ["redlandsc2", "redlandsc3"])
outInList.save("C:/sapyexamples/output/outinlist.tif")
Ejemplo 2 de InList (script independiente)

En este ejemplo se calculan los valores de celda de la primera entrada se encuentran en el conjunto de otros rásteres de entrada.

# Name: InList_Ex_02.py
# Description: Determines which values from the first input are
#              contained in the other inputs
# 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 = "redlandsc1"
inRaster2 = "redlandsc2"
inRaster3 = "redlandsc3"

# Execute InList
outInList = InList(inRaster1, [inRaster2, inRaster3])

# Save the output 
outInList.save("C:/sapyexamples/output/outinlist")

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