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

Ejemplo de valores de entrada y salida de la herramienta Frecuencia de igualdad
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

EtiquetaExplicaciónTipo 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

EtiquetaExplicaciónTipo 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

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})
NombreExplicaciónTipo 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_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.

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)

En este ejemplo se calcula la cantidad de veces que un conjunto de rásteres de entrada es igual a otro ráster y se genera como salida 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)

En este ejemplo se calcula la cantidad de veces que un conjunto de rásteres de entrada es igual a otro ráster y se genera como salida 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")

Información de licenciamiento

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

Temas relacionados