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

Ilustración de Igual a frecuencia dada
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.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})
ParámetroExplicació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