Estadísticas móviles dimensionales (Herramientas de Spatial Analyst)
Resumen
Calcula estadísticas en una ventana móvil de datos multidimensionales a lo largo de una dimensión especificada.
Uso
Las estadísticas móviles también se pueden denominar estadísticas de ventana móvil, estadísticas continuas o estadísticas en curso. 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.
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 valor del número de divisiones en zonas antes o por encima que se incluirán en la ventana definida. El valor debe ser un entero positivo entre 1 y 100. El valor predeterminado es 1.
La unidad de este parámetro es la división en zonas.
Long
Ventana siguiente
(Opcional)
El valor del número de divisiones en zonas después o por debajo que se incluirán en la ventana definida. El valor debe ser un entero positivo entre 1 y 100. El valor predeterminado es 1.
La unidad de este parámetro es la división en zonas.
Long
Manejo de NoData
(Opcional)
Especifica cómo se utilizarán los valores NoData por el cálculo de estadísticas.
Datos—Los valores NoData dentro de la ventana definida se ignorarán al calcular la estadística seleccionada. Para determinar el valor de salida solo se utilizarán las celdas dentro de la ventana definida que contengan valores de datos. Si la celda de procesamiento es NoData, esa celda recibirá un valor en la trama de salida, siempre que al menos una celda dentro de la ventana definida tenga un valor válido. Esta es la opción predeterminada.
NoData—Los valores de salida serán NoData si se encuentran valores NoData dentro de la ventana definida. La presencia de un valor NoData indica que no hay suficiente información para determinar el valor estadístico de la ventana definida.
Rellenar NoData—Los valores de celda NoData se sustituirán en la salida utilizando la estadística seleccionada calculada a partir de los valores dentro de la ventana definida. Las celdas de entrada que contengan valores de datos permanecerán iguales en la salida.
String
Tipo de estadísticas
(Opcional)
Especifica el tipo de estadística que se va a calcular.
Valor medio—Se calculará el valor medio de las celdas en la ventana definida. Esta es la opción predeterminada.
Valor medio circular—Se 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 especifica este tipo de estadística, el parámetro Valor de ajuste circular pasa a estar disponible. Utilice este parámetro para designar el valor de ajuste.
Mayoría—Se identificará la mayoría (valor que se produce con mayor frecuencia) de las celdas en la ventana definida.
Máximo—Se identificará el máximo (valor superior) de las celdas en la ventana definida.
Mediana—Se identificará la mediana de las celdas en la ventana definida.
Mínimo—Se identificará el mínimo (valor inferior) de las celdas en la ventana definida.
Percentil—Se calculará un percentil de las celdas en la ventana definida. El 90 percentil se calcula de forma predeterminada. Cuando se especifica 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)
Valor de percentil que se calculará. El valor predeterminado es 90, para el 90.º percentil.
Los valores pueden variar en un rango de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un 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 de 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ática—Si 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. Esta es la opción predeterminada.
Más cercano—Se utilizará el valor disponible más cercano para el percentil. En este caso, el tipo de píxel de salida será el mismo que el del ráster de entrada.
Lineal—Se 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 envoltura 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
Etiqueta
Explicación
Tipo 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
Etiqueta
Explicación
Tipo 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).
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 valor del número de divisiones en zonas antes o por encima que se incluirán en la ventana definida. El valor debe ser un entero positivo entre 1 y 100. El valor predeterminado es 1.
La unidad de este parámetro es la división en zonas.
Long
forward_window
(Opcional)
El valor del número de divisiones en zonas después o por debajo que se incluirán en la ventana definida. El valor debe ser un entero positivo entre 1 y 100. El valor predeterminado es 1.
La unidad de este parámetro es la división en zonas.
Long
nodata_handling
(Opcional)
Especifica cómo se utilizarán los valores NoData por el cálculo de estadísticas.
DATA—Los valores NoData dentro de la ventana definida se ignorarán al calcular la estadística seleccionada. Para determinar el valor de salida solo se utilizarán las celdas dentro de la ventana definida que contengan valores de datos. Si la celda de procesamiento es NoData, esa celda recibirá un valor en la trama de salida, siempre que al menos una celda dentro de la ventana definida tenga un valor válido. Esta es la opción predeterminada.
NODATA—Los valores de salida serán NoData si se encuentran valores NoData dentro de la ventana definida. La presencia de un valor NoData indica que no hay suficiente información para determinar el valor estadístico de la ventana definida.
FILL_NODATA—Los valores de celda NoData se sustituirán en la salida utilizando la estadística seleccionada calculada a partir de los valores dentro de la ventana definida. Las celdas de entrada que contengan valores de datos permanecerán iguales en la salida.
String
statistics_type
(Opcional)
Especifica el tipo de estadística que se va a calcular.
MEAN—Se calculará el valor medio de las celdas en la ventana definida. Esta es la opción predeterminada.
CIRCULAR_MEAN—Se 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 especifique este tipo de estadísticas, utilice el parámetro circular_wrap_value para designar el valor de ajuste.
MAJORITY—Se identificará la mayoría (valor que se produce con mayor frecuencia) de las celdas en la ventana definida.
MAXIMUM—Se identificará el máximo (valor superior) de las celdas en la ventana definida.
MEDIAN—Se identificará la mediana de las celdas en la ventana definida.
MINIMUM—Se identificará el mínimo (valor inferior) de las celdas en la ventana definida.
PERCENTILE—Se 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)
Valor de percentil que se calculará. El valor predeterminado es 90, para el 90.º percentil.
Los valores pueden variar en un rango de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un 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 está disponible 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_DETECT—Si 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.
NEAREST—Se utilizará el valor disponible más cercano para el percentil. En este caso, el tipo de píxel de salida será el mismo que el del ráster de entrada.
LINEAR—Se 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
Salida derivada
Nombre
Explicación
Tipo de datos
raster_function_arguments_json
Los argumentos de la función. Esta salida es solo para uso interno.
String
Valor de retorno
Nombre
Explicación
Tipo 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
Muestra de código
DimensionalMovingStatistics ejemplo 1 (ventana de Python)
En este ejemplo se calcula el valor medio en una ventana con tres divisiones alrededor de cada celda del ráster multidimensional de entrada.
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: Spatial Analyst extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set the analysis environment
env.workspace = "C:/sapyexamples/data"
# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"
# Run DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension,
backward_window, forward_window, nodata_handling,
statistics_type)
# Save the output
out_dimstats.save("C:/sapyexamples/output/mining_location_out.crf")