Posición más alta (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Determina la posición del ráster con el valor máximo en un conjunto de rásteres a través de cada celda individual.

Ilustración

OutRas = HighestPosition([InRas1, InRas2, InRas3])

Uso

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

• El orden de los rásteres de entrada es importante para esta herramienta.

• Cuando se especifica un ráster multibanda como uno de los valores del parámetro Rásteres o valores constantes de entrada (in_rasters_or_constants en Python), se utilizarán todas las bandas.

  Para procesar una selección de bandas a partir de un ráster multibanda, cree primero un dataset ráster formado por esas bandas concretas con la herramienta Bandas compuestas; después, utilice el resultado en la lista del parámetro Rásteres o valores constantes de entrada (in_rasters_or_constants en Python).

• 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.

• El ráster de salida siempre es de tipo entero.

• Si dos rásteres de entrada o más contienen el valor máximo para una ubicación de celda en particular, la posición de la primera se devuelve en el ráster de salida.

• Si todas las entradas son datos ráster 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. La salida será un ráster multidimensional en formato CRF. Las variables en las entradas deben tener al menos una dimensión común y un valor dimensional común para que esta herramienta procese; de lo contrario, se producirá un error.

  Si todas las entradas tienen una variable pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (definido como arcpy.env.matchMultidimensionalVariable = False en Python) antes de realizar la operación.

  Si una o varias de las entradas son rásteres multidimensionales y el resto de entradas son constantes, 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ásteres o valores constantes de entrada	La lista de rásteres de entrada para la que se determinará la posición de la entrada con el valor más alto. 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

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida. Para cada celda en el ráster de salida, el valor representa la posición del ráster con el valor más alto.	Raster

Python

HighestPosition(in_rasters_or_constants)

Nombre	Explicación	Tipo de datos
in_rasters_or_constants [in_raster_or_constant,...]	La lista de rásteres de entrada para la que se determinará la posición de la entrada con el valor más alto. 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

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de salida. Para cada celda en el ráster de salida, el valor representa la posición del ráster con el valor más alto.	Raster

Muestra de código

Ejemplo 1 de HighestPosition (ventana de Python)

Este ejemplo evalúa varios rásteres de entrada y devuelve como valor de salida la posición en la lista del ráster con el valor máximo.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outHighestPosition = HighestPosition(["degs", "negs", "fourgrd"])
outHighestPosition.save("C:/sapyexamples/output/outhp.img")

Ejemplo 2 de HighestPosition (secuencia de comandos independiente)

Este ejemplo evalúa varios rásteres de entrada y devuelve como valor de salida la posición en la lista del ráster con el valor máximo.

# Name: HighestPosition_Ex_02.py
# Description: Determines the position of a raster with the maximum
#              value in a set of rasters
# 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
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute HighestPosition
outHighestPosition = HighestPosition([inRaster01, inRaster02, inRaster03])

# Save the output 
outHighestPosition.save("C:/sapyexamples/output/outhp")

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

Información de licenciamiento

• Basic: Requiere Spatial Analyst
• Standard: Requiere Spatial Analyst
• Advanced: Requiere Spatial Analyst