Clasificación (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Clasifica los valores celda por celda a partir de un conjunto de rásteres de entrada y determina los valores que se devuelven en función del valor de clasificación del ráster de entrada.

Ilustración

OutRas = Rank(ConstRas, [InRas1, InRas2, InRas3])

Uso

• En la lista de rásteres de entrada el orden no es relevante. Sin embargo, el ráster que define la clasificación debe preceder a estos.

• Se puede especificar una cantidad de rásteres arbitraria en la lista de rásteres de entrada.

• Si la ubicación de una celda contiene NoData en cualquiera de los rásteres de entrada, esa ubicación será asignada como NoData en la salida.

• Si todos los valores de entrada son los mismos para cualquier ubicación de celda, independientemente de la clasificación especificada, la salida para esa ubicación de celda será ese valor.

• Si el valor del ráster de clasificación es mayor que la cantidad de rásteres de entrada, se asignará NoData a cada ubicación de celda de la salida.

• Si alguno de los rásteres de entrada es de punto flotante, la salida es de punto flotante; de lo contrario, es entero.

• Si el parámetro Procesar como multibanda está desactivado (process_as_multiband tiene el valor SINGLE_BAND en Python), solo se usará la primera banda de un Ráster de clasificación o valor constante de entrada multibanda (in_rank_raster_or_constant en Python). Cada banda de los Rásteres de entrada multibanda o valores constantes (in_rasters en Python) se procesará por separado como un ráster de banda única.

• 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 Ráster de clasificación o valor constante de entrada. Si el ráster de clasificación es de banda única, el número de bandas del ráster de salida tendrá el número máximo de bandas de todos los rásteres multibanda de los rásteres de entrada. Si el ráster de clasificación es multibanda, el ráster de salida tendrá el mismo número de bandas que el ráster de clasificación.

  Si cualquiera de los Rásteres de entrada es un ráster con un número menor de bandas que el ráster de salida, las bandas ausentes se interpretarán como una banda llena de NoData. Si el valor de celda del ráster de clasificación toma el valor uno de la banda ausente, el ráster de salida recibirá NoData. Si cualquiera de los rásteres de entrada es una constante, se interpretará como un ráster multibanda, en el que los valores de las celdas de todas las bandas son iguales a la constante y tienen el mismo número de bandas que el ráster de salida.

• En ArcPy, si todas las entradas son rásteres 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 y la salida será un ráster multidimensional. Las variables de las entradas deben tener las mismas dimensiones o dimensiones comunes.

  Si todas las entradas son rásteres multidimensionales con una variable, pero con nombres diferentes, establezca el entorno de geoprocesamiento matchMultidimensionalVariable en False para realizar la operación.

  En ArcPy, si una o varias 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.

• 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 clasificación o valor constante de entrada	El ráster de entrada que define la posición de clasificación que se devolverá. Se puede utilizar un número como entrada; sin embargo, primero se debe establecer el tamaño de la celda y la extensión en el entorno.	Raster Layer; Constant
Rásteres de entrada	La lista de rásteres de entrada de la que se obtendrá el valor de la celda del ráster en la posición de clasificación especificada. Por ejemplo, considere una ubicación concreta en la que los valores de las celdas en los tres rásteres de entrada son 17, 8 y 11. El valor de clasificación de esa ubicación se define como 3. La herramienta ordena primero los valores de entrada. Dado que el valor de clasificación solicitado es 3, el valor de salida será 17.	Raster Layer
Procesar como multibanda (Opcional)	Especifica cómo se procesarán las bandas de ráster multibanda de entrada. Desactivado: cada 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. Activado: cada 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

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida. Para cada celda del ráster de salida, los valores de los rásteres de entrada se ordenan de menor a mayor, y el valor del ráster de clasificación de entrada se utiliza para seleccionar cuál será el valor de salida.	Raster

Python

Rank(in_rank_raster_or_constant, in_rasters, {process_as_multiband})

Nombre	Explicación	Tipo de datos
in_rank_raster_or_constant	El ráster de entrada que define la posición de clasificación que se devolverá. Se puede utilizar un número como entrada; sin embargo, primero se debe establecer el tamaño de la celda y la extensión en el entorno.	Raster Layer; Constant
in_rasters [in_raster,...]	La lista de rásteres de entrada de la que se obtendrá el valor de la celda del ráster en la posición de clasificación especificada. Por ejemplo, considere una ubicación concreta en la que los valores de las celdas en los tres rásteres de entrada son 17, 8 y 11. El valor de clasificación de esa ubicación se define como 3. La herramienta ordena primero los valores de entrada. Dado que el valor de clasificación solicitado es 3, el valor de salida será 17.	Raster Layer
process_as_multiband (Opcional)	Especifica cómo se procesarán las bandas de ráster multibanda de entrada. SINGLE_BAND—Cada 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_BAND—Cada 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

Nombre	Explicación	Tipo de datos
out_raster	El ráster de salida. Para cada celda del ráster de salida, los valores de los rásteres de entrada se ordenan de menor a mayor, y el valor del ráster de clasificación de entrada se utiliza para seleccionar cuál será el valor de salida.	Raster

Muestra de código

Ejemplo 1 de Clasificación (ventana de Python)

En este ejemplo se realiza una operación de clasificación sobre varios rásteres de cuadrícula de entrada y se genera como resultado un ráster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRank = Rank("cost", ["degs", "negs", "fourgrd"])
outRank.save("C:/sapyexamples/output/outrank.tif")

Ejemplo 2 de Clasificación (secuencia de comandos independiente)

En este ejemplo se realiza una operación de clasificación sobre varios rásteres de cuadrícula de entrada y se genera como resultado un ráster de cuadrícula.

# Name: Rank_Ex_02.py
# Description: Returns the value of a set of rasters based on
#              a rank level specified by another raster 
# 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
inRankRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute Rank
outRank = Rank(inRankRaster, [inRaster01, inRaster02, inRaster03])

# Save the output 
outRank.save("C:/sapyexamples/output/outrank")

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
• Standard: Requiere Spatial Analyst
• Advanced: Requiere Spatial Analyst