Estadísticas móviles dimensionales (Image Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Calcula las estadísticas en una ventana móvil de datos multidimensionales a lo largo de una dimensión especificada.

Uso

  • Mover estadísticas también se puede denominar estadísticas de ventana móvil, estadísticas continuas o ejecutar estadísticas. Se utiliza una ventana predefinida alrededor de cada valor de dimensión para calcular varias estadísticas antes de pasar a la siguiente. Los parámetros Ventana anterior y Ventana siguiente le permiten definir los tamaños de ventana a ambos lados de la dimensión.

  • El ráster de entrada solo puede ser un ráster multidimensional en formato de ráster de nube (archivo .crf).

  • Con esta herramienta solo se procesará una dimensión. De forma predeterminada, la primera dimensión que no sea x,y se utilizará como dimensión de procesamiento.

  • El tipo de estadísticas Valor medio circular calcula el valor medio para los ángulos u otras cantidades cíclicas, por ejemplo, la dirección de la brújula en grados. Cuando se selecciona esta opción, el parámetro Valor de ajuste circular pasa a estar disponible. Utilice este parámetro para designar un valor de ajuste para calcular el valor medio circular. Por ejemplo, para calcular ángulos, el valor de ajuste circular debe ser 360 grados, lo que significa que el valor 360 se ajustará a 0 y el valor 370 se ajustará a 10. Otro de sus usos es para realizar cálculos de tiempo de meses en un año, en cuyo caso el valor de ajuste circular debería ser 12. En este caso, un valor de entrada de 13 se ajustará a 1.

  • Si el ráster multidimensional de entrada es un entero, las opciones válidas para Tipo de estadísticas son Valor medio, Valor medio circular, Mayoría, Máximo, Mediana, Mínimo y Percentil. Si el ráster de entrada es flotante, Mayoría no está disponible.

  • Si el ráster de entrada es un entero, el ráster de salida será un entero para las opciones Mayoría, Máximo y Mínimo. El valor de salida será flotante para Valor medio, Valor medio circular, Mediana y Percentil.

    Si el ráster de entrada es de tipo de punto flotante, la salida será de tipo flotante para todos los tipos de estadísticas disponibles.

  • En la opción Mayoría, cuando hay un empate, la salida será el más bajo de los valores coincidentes.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de entrada

El ráster de entrada solo puede ser un ráster multidimensional en formato de ráster de nube (archivo .crf).

Raster Layer
Dimensión
(Opcional)

El nombre de la dimensión por la que se moverá la ventana.

El valor predeterminado es la primera dimensión distinta de x,y encontrada en el ráster multidimensional de entrada.

String
Ventana anterior
(Opcional)

El número de divisiones anteriores o superiores que se incluirán en la ventana definida. El valor debe ser un número entero positivo de 1 a 100. El valor predeterminado es 1.

La unidad de este parámetro es la división.

Long
Ventana siguiente
(Opcional)

El número de divisiones posteriores o inferiores que se incluirán en la ventana definida. El valor debe ser un número entero positivo de 1 a 100. El valor predeterminado es 1.

La unidad de este parámetro es la división.

Long
Manejo de NoData
(Opcional)

Especifica cómo se utilizarán los valores NoData por el cálculo de estadísticas.

  • DatosLos valores NoData de la entrada de valores se ignorarán en los resultados de la ventana definida a la que pertenecen. Esta es la opción predeterminada.
  • NoDataLos valores de salida serán NoData si se encuentra algún valor NoData en la entrada dentro de la ventana definida.
  • Rellenar NoDataLos valores de celda NoData se reemplazarán con la estadística seleccionada en los valores dentro de la ventana definida.
String
Tipo de estadísticas
(Opcional)

Especifica el tipo de estadística que se calculará.

  • Valor medioSe calculará la media (valor medio) de las celdas en la ventana definida. Esta es la opción predeterminada.
  • Valor medio circularSe calculará la media para ángulos u otras cantidades cíclicas, como el rumbo en grados, horas diurnas o fracciones de números reales. Cuando se selecciona este tipo de estadísticas, el parámetro Valor de ajuste circular pasa a estar disponible. Utilice este parámetro para designar el valor de ajuste.
  • MayoríaSe identificará la mayoría (valor que se produce con mayor frecuencia) de las celdas en la ventana definida.
  • MáximoSe identificará el máximo (valor superior) de las celdas en la ventana definida.
  • MedianaSe calculará la mediana de las celdas en la ventana definida.
  • MínimoSe identificará el mínimo (valor inferior) de las celdas en la ventana definida.
  • PercentilSe calculará un percentil de las celdas en la ventana definida. El 90.º percentil se calcula de forma predeterminada. Cuando se selecciona este tipo de estadísticas, los parámetros Valor de percentil y Tipo de interpolación de percentil pasan a estar disponibles. Utilice estos nuevos parámetros para designar el percentil para calcular y elegir respectivamente el tipo de interpolación que se va a utilizar.
String
Valor de percentil
(Opcional)

El valor de percentil que se calculará. El valor predeterminado es 90, para el 90.º percentil.

El valor puede variar de 0 a 100. El percentil 0 equivale en esencia a la estadística mínima, mientras que el percentil 100 equivale a la estadística máxima. El valor de 50 generará en esencia el mismo resultado que la estadística mediana.

Este parámetro solo se admite si el parámetro Tipo de estadísticas está establecido en Percentil.

Double
Tipo de interpolación percentil
(Opcional)

Especifica el método de interpolación que se va a utilizar cuando el valor de percentil se encuentra entre los valores de dos celdas.

Este parámetro solo se admite si el parámetro Tipo de estadísticas está establecido en Mediana o Percentil.

  • Detección automáticaSi el ráster de entrada es de tipo píxel entero, se utilizará el método Más cercano. Si el ráster de entrada es de tipo píxel de punto flotante, se utilizará el método Lineal.
  • Más cercanoSe utilizará el valor disponible más cercano al percentil. En este caso, el tipo de píxel de salida será el mismo que el del ráster de entrada.
  • LinealSe utilizará la media ponderada de los dos valores circundantes del percentil. En este caso, el tipo de píxel de salida será un punto flotante.
String
Valor de ajuste circular
(Opcional)

Valor que se utilizará para convertir un valor lineal al rango de un valor circular determinado. El valor debe ser positivo. El valor predeterminado es 360 grados.

Este parámetro solo se admite si el parámetro Tipo de estadísticas está establecido en Valor medio circular.

Double

Salida derivada

EtiquetaExplicaciónTipo de datos
Argumentos de la función de ráster JSON

Los argumentos de la función. Esta salida es solo para uso interno.

String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de salida

El ráster de salida solo puede ser un ráster multidimensional en formato de ráster de nube (archivo .crf).

Raster

DimensionalMovingStatistics(in_raster, {dimension}, {backward_window}, {forward_window}, {nodata_handling}, {statistics_type}, {percentile_value}, {percentile_interpolation_type}, {circular_wrap_value})
NombreExplicaciónTipo de datos
in_raster

El ráster de entrada solo puede ser un ráster multidimensional en formato de ráster de nube (archivo .crf).

Raster Layer
dimension
(Opcional)

El nombre de la dimensión por la que se moverá la ventana.

El valor predeterminado es la primera dimensión distinta de x,y encontrada en el ráster multidimensional de entrada.

String
backward_window
(Opcional)

El número de divisiones anteriores o superiores que se incluirán en la ventana definida. El valor debe ser un número entero positivo de 1 a 100. El valor predeterminado es 1.

La unidad de este parámetro es la división.

Long
forward_window
(Opcional)

El número de divisiones posteriores o inferiores que se incluirán en la ventana definida. El valor debe ser un número entero positivo de 1 a 100. El valor predeterminado es 1.

La unidad de este parámetro es la división.

Long
nodata_handling
(Opcional)

Especifica cómo se utilizarán los valores NoData por el cálculo de estadísticas.

  • DATALos valores NoData de la entrada de valores se ignorarán en los resultados de la ventana definida a la que pertenecen. Esta es la opción predeterminada.
  • NODATALos valores de salida serán NoData si se encuentra algún valor NoData en la entrada dentro de la ventana definida.
  • FILL_NODATALos valores de celda NoData se reemplazarán con la estadística seleccionada en los valores dentro de la ventana definida.
String
statistics_type
(Opcional)

Especifica el tipo de estadística que se calculará.

  • MEANSe calculará la media (valor medio) de las celdas en la ventana definida. Esta es la opción predeterminada.
  • CIRCULAR_MEANSe calculará la media para ángulos u otras cantidades cíclicas, como el rumbo en grados, horas diurnas o fracciones de números reales. Cuando se seleccione este tipo de estadísticas, utilice el parámetro circular_wrap_value para designar el valor de ajuste.
  • MAJORITYSe identificará la mayoría (valor que se produce con mayor frecuencia) de las celdas en la ventana definida.
  • MAXIMUMSe identificará el máximo (valor superior) de las celdas en la ventana definida.
  • MEDIANSe calculará la mediana de las celdas en la ventana definida.
  • MINIMUMSe identificará el mínimo (valor inferior) de las celdas en la ventana definida.
  • PERCENTILESe calculará un percentil de las celdas en la ventana definida. El 90.º percentil se calcula de forma predeterminada. Cuando se selecciona este tipo de estadísticas, utilice los parámetros percentile_value y percentile_interpolation_type para designar el percentil para calcular y elegir respectivamente el tipo de interpolación que se va a utilizar.
String
percentile_value
(Opcional)

El valor de percentil que se calculará. El valor predeterminado es 90, para el 90.º percentil.

El valor puede variar de 0 a 100. El percentil 0 equivale en esencia a la estadística mínima, mientras que el percentil 100 equivale a la estadística máxima. El valor de 50 generará en esencia el mismo resultado que la estadística mediana.

Este parámetro solo está disponible si el parámetro statistics_type está establecido en PERCENTILE. Si se especifica cualquier otro tipo de estadística, este parámetro se omite.

Double
percentile_interpolation_type
(Opcional)

Especifica el método de interpolación que se va a utilizar cuando el valor de percentil se encuentra entre los valores de dos celdas.

Este parámetro solo se admite si el parámetro statistics_type está establecido en MEDIAN o PERCENTILE. Si se especifica cualquier otro tipo de estadística, este parámetro se omite.

  • AUTO_DETECTSi el ráster de entrada es de tipo píxel entero, se utilizará el método NEAREST. Si el ráster de entrada es de tipo píxel de punto flotante, se utilizará el método LINEAR.
  • NEARESTSe utilizará el valor disponible más cercano al percentil. En este caso, el tipo de píxel de salida será el mismo que el del ráster de entrada.
  • LINEARSe utilizará la media ponderada de los dos valores circundantes del percentil. En este caso, el tipo de píxel de salida será un punto flotante.
String
circular_wrap_value
(Opcional)

Valor que se utilizará para convertir un valor lineal al rango de un valor circular determinado. El valor debe ser positivo. El valor predeterminado es 360 grados.

Este parámetro solo está disponible si el parámetro statistics_type está establecido en CIRCULAR_MEAN. Si se especifica cualquier otro tipo de estadística, este parámetro se omite.

Double

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida solo puede ser un ráster multidimensional en formato de ráster de nube (archivo .crf).

Raster

Salida derivada

NombreExplicaciónTipo de datos
raster_function_arguments_json

Los argumentos de la función. Esta salida es solo para uso interno.

String

Muestra de código

DimensionalMovingStatistics example 1 (Python window)

En este ejemplo se calcula el valor medio en una ventana con tres divisiones alrededor de cada celda del ráster multidimensional de entrada.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
out_dimstats = DimensionalMovingStatistics("md_raster.crf", "StdTime",
                                           1, 1, "NODATA", "MEAN")
out_dimstats.save("C:/iapyexamples/output/DMS01.crf")
DimensionalMovingStatistics example 2 (stand-alone script)

En este ejemplo se determina el valor que ocurre con más frecuencia en una ventana móvil de cinco divisiones alrededor de cada celda del ráster multidimensional de entrada.

# Name: DimensionalMovingStatistics_standalone.py
# Description: Calculates majority on a multidimensional raster 
#                along its time dimension.
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Set the analysis environment
env.workspace = "C:/iapyexamples/data"

# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"

# Execute DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension, 
                 backward_window, forward_window, nodata_handling, 
                 statistics_type)

# Save the output
out_dimstats.save("C:/iapyexamples/output/mining_location_out.crf")

Información de licenciamiento

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

Temas relacionados