Popularidad (Herramientas de Spatial Analyst)

Resumen

Determina el valor en una lista de argumentos que se encuentra en un nivel determinado de popularidad celda por celda. El primer argumento indica el nivel de popularidad concreto (el número de veces que se produce cada valor).

Ilustración

OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

Uso

• The tool evaluates the number of occurrences of the input raster values for each location and ranks them on an ordinal scale—es decir, el más popular, el segundo más popular, y así sucesivamente. Devolverá el valor del enésimo valor más popular especificado, definido por el valor del ráster de popularidad.

• En la lista de rásteres de entrada el orden no es relevante. No obstante, el ráster que define la posición de popularidad debe precederlos.

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

• Si los valores de entrada son los mismos para cada ubicación de celda, independientemente de la popularidad especificada, el valor de salida será el mismo que la entrada para esa ubicación de celda.

• 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 no se encuentra un valor único para ser el enésimo más popular, se asignará NoData a la ubicación en el ráster de salida. Esta situación ocurre cuando todos los valores del ráster de entrada en una ubicación son diferentes o cuando dos valores de ráster de entrada o más tienen la misma cantidad de ocurrencias y esa cantidad es el enésimo más popular. La devolución de uno de los valores de ráster de entrada, como el primero encontrado en el proceso de escaneo, sería engañosa. Sería imposible saber si el valor es realmente el enésimo valor más popular.

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

• Si se especifica 0 como el valor de popularidad, el valor de salida será NoData.

• Un nivel de popularidad de 1 es el valor de mayoría, similar a la opción Mayoría de la herramienta Estadísticas de celdas.

• 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 está establecido como SINGLE_BAND en Python), solo se usará la primera banda de un Ráster de popularidad o valor constante de entrada multibanda (in_popularity_raster_or_constant en Python). Cada banda de los Rásteres de entrada multibanda (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 está establecido como MULTI_BAND en Python), cada entrada de ráster multibanda se procesará como un ráster multibanda.

  El número de bandas de la salida depende del Ráster de popularidad o valor constante de entrada. Si el ráster de popularidad 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 popularidad es multibanda, el ráster de salida tendrá el mismo número de bandas que el ráster de popularidad.

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

• 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 válidos para esta herramienta.

Parámetros

• Dialog
• Python

Etiqueta	Explicación	Tipo de datos
Ráster de popularidad o valor constante de entrada	El ráster de entrada que define la posición de popularidad que se desea 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 utilizados para evaluar la popularidad de los valores para cada ubicación de celda.	Raster Layer
Procesar como multibanda (Opcional)	Especifica cómo se procesarán las bandas de ráster multibanda de entrada. 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. 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.	Boolean

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida. Cada celda del ráster de salida representa el valor desde la misma ubicación de los rásteres de entrada que cumplen con el valor de popularidad de entrada.	Raster

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

Temas relacionados

• Una vista general del conjunto de herramientas Local
• Buscar una herramienta de geoprocesamiento
• Encontrar el valor de una lista de entrada que cumpla un criterio especificado
• Rango