Menor que frecuencia dada (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Evalúa la cantidad de veces que un conjunto de rásteres es menor que otro ráster a través de cada celda individual.

Ilustración

Ejemplo de valores de entrada y salida de la herramienta Frecuencia de menor que
OutRas = LessThanFrequency(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 válidos para 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 (frecuencia) en que un ráster en la lista de entrada tiene un valor menor.

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 menores que el ráster de valor.

Raster

LessThanFrequency(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 (frecuencia) en que un ráster en la lista de entrada tiene un valor menor.

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 menores que el ráster de valor.

Raster

Muestra de código

Ejemplo 1 de LessThanFrequency (ventana de Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLTF = LessThanFrequency("cost", ["degs", "negs", "fourgrd"])
outLTF.save("C:/sapyexamples/output/outltf.img")
Ejemplo 2 de LessThanFrequency (secuencia de comandos independiente)

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

# Name: LessThanFrequency_Ex_02.py
# Description: Evaluates the number of times a set of rasters is
#              less than another raster
# 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 LessThanFrequency
outLTF = LessThanFrequency(inValueRaster, [inRaster01, inRaster02, inRaster03])

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

Información de licenciamiento

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

Temas relacionados