Frecuencia de igualdad (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Evalúa a través de cada celda individual la cantidad de veces que los valores de un conjunto de rásteres son iguales a otro ráster.

Ilustración

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

Uso

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

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

• 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áster de valor de entrada	Para cada ubicación de celda en el ráster de valor de entrada, cuenta la cantidad de ocurrencias (la frecuencia) en que un ráster en la lista de entrada tiene un valor igual.	Raster Layer
Rásteres de entrada	Lista de rásteres que se compararán con el ráster de valores.	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 en el ráster de salida, el valor representa la cantidad de veces que las celdas correspondientes en la lista de rásteres son las mismas que el ráster de valor.	Raster

Python

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})

Nombre	Explicación	Tipo de datos
in_value_raster	Para cada ubicación de celda en el ráster de valor de entrada, cuenta la cantidad de ocurrencias (la frecuencia) en que un ráster en la lista de entrada tiene un valor igual.	Raster Layer
in_rasters [in_raster,...]	Lista de rásteres que se compararán con el ráster de valores.	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 en el ráster de salida, el valor representa la cantidad de veces que las celdas correspondientes en la lista de rásteres son las mismas que el ráster de valor.	Raster

Muestra de código

Ejemplo 1 de EqualToFrequency (ventana de Python)

Este ejemplo evalúa el número de veces que un conjunto de rásteres de entrada es igual a otro ráster y muestra el resultado como un ráster TIFF.

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

Ejemplo 2 de EqualToFrequency (secuencia de comandos independiente)

Este ejemplo evalúa el número de veces que un conjunto de rásteres de entrada es igual a otro ráster y muestra el resultado como un ráster de cuadrícula.

# Name: EqualToFrequency_Ex_02.py
# Description: Evaluates the number of times a set of rasters is
#              equal to another raster on a cell-by-cell basis
# 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
inValueRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute EqualToFrequency
outETF = EqualToFrequency(inValueRaster, [inRaster01, inRaster02, inRaster03])

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

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