Estadísticas focalizadas (Herramientas de Spatial Analyst)

Resumen

Para cada ubicación de celda de entrada, calcula una estadística de los valores dentro de una vecindad especificada alrededor de ella.

Más información sobre cómo funcionan las Estadísticas focalizadas

Ilustración

OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,"CELL"), "SUM", "DATA")

Uso

• Existen varias formas de vecindad y tipos de estadísticas para elegir. Las estadísticas disponibles dependen del tipo de ráster de entrada.

• Las formas de vecindad disponibles son anillo (un donut o anillo), círculo, rectángulo y cuña. Se puede definir una forma de vecindad personalizada utilizando un archivo kernel.

• Cuando se especifica una vecindad circular, con forma de anillo o con forma de cuña, es probable que para el cálculo no se tengan en cuenta algunas celdas diagonales externas, ya que la vecindad debe abarcar el centro de la celda.

• Los tipos de Vecindad irregular y peso requieren que se especifique un valor de Archivo kernel. Un archivo kernel es un archivo de texto ASCII que especifica los valores y la forma de la vecindad. El archivo se puede crear con cualquier editor de texto sin formato. El archivo debe tener una extensión .txt y no contener espacios en el nombre del archivo.

  Consulte las secciones Irregular y Peso de Cómo funciona Estadísticas focalizadas para obtener información sobre la creación y el uso de archivos de kernel.

• En el caso de los rásteres de entrada, las estadísticas válidas para Tipo de estadísticas son: mayoría, máximo, valor medio, mediana, mínimo, minoría, percentil, rango, desviación estándar, suma y variedad. En el caso de los rásteres de entrada flotantes, las estadísticas válidas son: máximo, valor medio, mediana, mínimo, percentil, rango, desviación estándar y suma. Mayoría, minoría y variedad no están disponibles para los rásteres de entrada flotantes.

• Si el ráster de entrada es un entero, el ráster de salida será un entero para los tipos de estadísticas mayoría, máximo, mínimo, minoría, rango, suma y variedad. La salida será flotante para los tipos de estadísticas valor medio, mediana, percentil y desviación estándar.

  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.

• Para los cálculos de mediana, si una vecindad tiene una cantidad impar de celdas, se clasifican los valores y se informa del valor medio como la mediana. Si la vecindad contiene un número par de celdas, se clasifican los valores y se promedian los dos valores centrales.

• Para los cálculos de mayoría y minoría, consulte el tema Cómo funciona Estadísticas focalizadas para obtener más información cuando hay un empate.

• El valor del parámetro Vecindad se puede cambiar a Peso solo para las estadísticas de tipo Valor medio, Desviación estándar y Suma.

• Las celdas NoData de entrada pueden recibir un valor en la salida si el parámetro Ignorar los NoData en los cálculos se ha activado, siempre que haya al menos una celda de la vecindad que tenga un valor válido.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

• Dialog
• Python

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	El ráster en que se calcularán las estadísticas focalizadas para cada celda de entrada.	Raster Layer
Vecindario (Opcional)	Las celdas alrededor de una celda de procesamiento que se utilizarán en el cálculo de estadísticas. Hay varios tipos de vecindad predefinidos para elegir, o se puede definir un kernel personalizado. Una vez que se haya seleccionado el tipo de vecindad, se pueden establecer los demás parámetros para definir completamente la forma, el tamaño y las unidades de medida. La vecindad predeterminada es un rectángulo cuadrado con un ancho y una altura de tres celdas. A continuación se detallan las formas de los tipos de vecindad disponibles: Anillo, Radio interno, Radio externo, Tipo de unidades Un anillo o vecindad en forma de donut definido por un radio interno y un radio externo. El valor mínimo para el radio es 1 celda, y el radio exterior debe ser mayor que el interior. El radio interno máximo son 2.046 celdas y el radio externo máximo son 2.047 celdas. El anillo predeterminado tiene un radio interior de 1 celda y un radio exterior de 3 celdas. Círculo, Radio, Tipo de unidades Una vecindad circular con un radio determinado. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. El radio predeterminado es de 3 celdas. Rectángulo, Altura, Ancho, Tipo de unidades Una vecindad rectangular definida por el ancho y la altura. El valor mínimo para la anchura o la altura es 1 celda y el valor máximo son 4.096 celdas. El valor predeterminado es un cuadrado con un ancho y una altura de 3 celdas. Porción de círculo, Radio, Ángulo de inicio, Ángulo de finalización, Tipo de unidades Una vecindad en forma de cuña definida por un radio, un ángulo de inicio y un ángulo de finalización. El valor mínimo para el radio es 1 celda y el valor máximo es 2047 celdas. La cuña se extiende en el sentido contrario a las agujas del reloj desde el ángulo de inicio al ángulo de finalización. Los ángulos se especifican en grados, donde 0 ó 360 representan el este. Se pueden utilizar ángulos negativos. La cuña predeterminada es de 0 a 90 grados, con un radio de 3 celdas. Irregular, Archivo kernel Una vecindad personalizada con especificaciones establecidas por el archivo de texto kernel identificado. El valor mínimo para la anchura o la altura del kernel es 1 celda y el valor máximo son 4.096 celdas. Peso, Archivo kernel Una vecindad personalizada con especificaciones establecidas por el archivo de texto kernel identificado, que puede aplicar pesos a los miembros de la vecindad. El valor mínimo para la anchura o la altura del kernel es 1 celda y el valor máximo son 4.096 celdas. Para los tipos de vecindades de anillo, círculo, rectángulo y porción de círculo, las unidades de distancia para los parámetros pueden especificarse en unidades de Celda o unidades de Mapa. Las unidades de celda son las predeterminadas. Para las vecindades de kernel, la primera línea del archivo kernel define el ancho y la altura de la vecindad en números de celdas. Las líneas subsiguientes indican cómo se procesará el valor de entrada que se corresponde con la ubicación en el kernel. Un valor de 0 en el archivo de kernel para el tipo de vecindad irregular o ponderada indica que la ubicación correspondiente no se incluirá en el cálculo. Para la vecindad irregular, un valor de 1 en el archivo de kernel indica que la celda de entrada correspondiente se incluirá en la operación. Para la vecindad ponderada, el valor en cada posición indica por cuánto se multiplicará el valor de celda de entrada correspondiente. Se pueden utilizar valores positivos, negativos y decimales.	Neighborhood
Tipo de estadísticas (Opcional)	Especifica el tipo de estadística que se calculará. El tipo de estadísticas por defecto es Valor medio. Si el ráster de entrada es de tipo entero, están disponibles todos los tipos de estadísticas. Si el ráster de entrada es de punto flotante, solo están disponibles los tipos de estadísticas Valor medio, Máximo, Mediana, Mínimo, Percentil, Rango, Desviación estándar y Suma. Valor medio—Se calculará la media (valor medio) de las celdas en la vecindad. Mayoría—Se identificará la mayoría (valor que se produce con mayor frecuencia) de las celdas en la vecindad. Máximo—Se identificará el máximo (valor superior) de las celdas en la vecindad. Mediana—Se calculará la mediana de las celdas en la vecindad. La mediana es equivalente al percentil 50. Mínimo—Se identificará el mínimo (valor inferior) de las celdas en la vecindad. Minoría—Se identificará la minoría (valor que se produce con menor frecuencia) de las celdas en la vecindad. Percentil—Se calculará un percentil de las celdas en la vecindad. El 90 percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valor de percentil. Rango—Se calculará el rango (diferencia entre los valores superior e inferior) de las celdas en la vecindad. Desviación estándar—Se calculará la desviación estándar de las celdas en la vecindad. Suma—Se calculará la suma de las celdas en la vecindad. Variedad—Se calculará la variedad (el número de valores únicos) de las celdas en la vecindad.	String
Ignorar los NoData en los cálculos (Opcional)	Especifica si los valores NoData serán ignorados por el cálculo de estadísticas. Activado—Si existe un valor NoData dentro de una vecindad, este se ignorará. Para determinar el valor de salida solo se utilizarán las celdas dentro de la vecindad que contengan valores de datos. Si el valor de la propia celda de procesamiento es NoData, la celda de procesamiento puede recibir un valor en el ráster de salida, siempre que haya al menos una celda en la vecindad que tenga un valor válido. Esta es la opción predeterminada. Desactivado—Si alguna celda de una vecindad tiene el valor de NoData, incluida la celda de procesamiento, la salida de la celda de procesamiento será NoData. La presencia de un valor NoData implica que no hay información suficiente para determinar el valor estadístico de la vecindad.	Boolean
Valor de percentil (Opcional)	Valor de percentil que se calculará. El valor predeterminado es 90, para el 90.º percentil. El valor puede variar 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. Esta opción solo se admite si el parámetro Tipo de estadísticas está establecido en Percentil. Si se especifica cualquier otro tipo de estadística, este parámetro se omite.	Double

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de estadísticas focalizadas de salida.	Raster

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Factor de procesamiento en paralelo, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

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

Temas relacionados

• Una vista general del conjunto de herramientas Vecindad
• Buscar una herramienta de geoprocesamiento
• Calcular estadísticas para vecindades superpuestas y no superpuestas
• Función Estadísticas focales