Estadísticas de punto (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Calcula una estadística de los puntos en una vecindad alrededor de cada celda de salida.

Más información sobre cómo funciona Estadísticas de punto

Uso

• Existen varias formas de vecindad y tipos de estadísticas para elegir. La selección de estadísticas disponibles depende del tipo de campo especificado.

• En el caso de los campos de tipo entero, las opciones válidas para Tipo de estadísticas son: mayoría, máximo, valor medio, mediana, mínimo, minoría, rango, desviación estándar, suma y variedad. En el caso de los campos de valores flotantes, las estadísticas válidas son: máximo, valor medio, mínimo, rango, desviación estándar y suma. No están disponibles mayoría, minoría ni variedad.

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

  Si el tipo de campo es flotante, el ráster de salida será flotante en el caso de todos los tipos de estadísticas disponibles.

• Si no hay ningún punto en la vecindad de una celda ráster, la estadística Variedad le asigna un valor de 0. Para las otras estadísticas, se asigna NoData.

• El parámetro Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse a partir de un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro o el tamaño de celda del entorno, pero se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se especifica nada, el tamaño de celda se calcula a partir de la anchura o la altura de la extensión dividido por 250, donde la extensión se encuentra en el sistema de coordenadas de salida especificado en el entorno.

• Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.

  Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente de la referencia espacial de salida, se proyectará en función del valor de Método de proyección de tamaño de celda especificado.

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de puntos de entrada	Los puntos de entrada que se utilizan en esta operación de vecindad. Para cada celda de salida, se identifican todos los puntos de entrada que recaen dentro de la forma de vecindad definida alrededor de ella. Para los puntos seleccionados, se obtienen los valores del atributo especificado y se calcula una estadística. La entrada puede ser una clase de entidad de punto o multipunto.	Feature Layer
Campo	El campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de punto de entrada. Puede ser el campo Shape si las entidades de entrada contienen valores z.	Field
Tamaño de celda de salida (Opcional)	El tamaño de celda del ráster de salida que se va a crear. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.	Analysis Cell Size
Vecindario (Opcional)	El área alrededor de cada celda de procesamiento dentro de la cual se utilizarán los puntos de entrada encontrados en el cálculo de estadísticas. Hay varios tipos de vecindad predefinidos para elegir. 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 Una vecindad con forma de donut o anillo definida 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 interior máximo es de 2046 celdas, y el radio exterior máximo es de 2047 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 de ancho o alto es 1 celda, y el valor máximo es 4096 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 o 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. Las unidades de distancia para los parámetros se pueden especificar en unidades de Celda o unidades de Mapa. Las unidades de celda son las predeterminadas.	Neighborhood
Tipo de estadísticas (Opcional)	Especifica el tipo de estadística que se calculará. El cálculo se realiza sobre los valores del campo especificado de los puntos que se encuentren dentro la vecindad especificada de cada celda de ráster de salida. El tipo de estadísticas por defecto es Valor medio. Las opciones disponibles para el tipo de estadística vienen determinadas por el tipo numérico del campo especificado. Si el campo es de tipo entero, están disponibles todos los tipos de estadísticas. Si el campo es de punto flotante, solo estarán disponibles los tipos de estadísticas máximo, valor medio, mínimo, rango, desviación estándar y suma. Valor medio—Se calculará el promedio de los valores de campo en cada vecindad. Mayoría—Se identificará el valor de campo que ocurre con mayor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior. Máximo—Se identificará el valor de campo más grande en cada vecindad. Mediana—Se calculará el valor del campo mediano en cada vecindad. En el caso de que haya un número par de puntos en la vecindad, el resultado será el menor de los dos valores medios. Mínimo—Se identificará el valor de campo más pequeño en cada vecindad. Minoría—Se identificará el valor de campo que ocurre con menor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior. Rango—Se calculará el rango (la diferencia entre los valores más grande y más pequeño) de los valores de campo en cada vecindad. Desviación estándar—Se calculará la desviación estándar de los valores de campo en cada vecindad. Suma—Se calculará la suma de los valores de campo en la vecindad. Variedad—Se calculará la cantidad de valores de campo únicos en cada vecindad.	String

Valor de retorno

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

Python

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})

Nombre	Explicación	Tipo de datos
in_point_features	Los puntos de entrada que se utilizan en esta operación de vecindad. Para cada celda de salida, se identifican todos los puntos de entrada que recaen dentro de la forma de vecindad definida alrededor de ella. Para los puntos seleccionados, se obtienen los valores del atributo especificado y se calcula una estadística. La entrada puede ser una clase de entidad de punto o multipunto.	Feature Layer
field	El campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de punto de entrada. Puede ser el campo Shape si las entidades de entrada contienen valores z.	Field
cell_size (Opcional)	El tamaño de celda del ráster de salida que se va a crear. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.	Analysis Cell Size
neighborhood (Opcional)	El área alrededor de cada celda de procesamiento dentro de la cual se utilizarán los puntos de entrada encontrados en el cálculo de estadísticas. Hay varios tipos de vecindad predefinidos para elegir. 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. La forma de las vecindades alrededor de cada punto de entrada se define por la clase. Neighborhood. Los tipos de vecindad disponibles son NbrAnnulus, NbrCircle, NbrRectangle, y NbrWedge. A continuación se detallan las formas de los tipos de vecindad disponibles: NbrAnnulus({innerRadius}, {outerRadius}, {units}) Una vecindad con forma de donut o anillo definida 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 interior máximo es de 2046 celdas, y el radio exterior máximo es de 2047 celdas. El anillo predeterminado tiene un radio interior de 1 celda y un radio exterior de 3 celdas. NbrCircle({radius}, {units} 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. NbrRectangle({width}, {height}, {units}) Una vecindad rectangular definida por el ancho y la altura. El valor mínimo de ancho o alto es 1 celda, y el valor máximo es 4096 celdas. El valor predeterminado es un cuadrado con un ancho y una altura de 3 celdas. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) 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 o 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. Las unidades de distancia para los parámetros se pueden especificar en unidades de CELL o unidades de MAP. Las unidades de celda son las predeterminadas. El tipo de vecindad predeterminado es NbrRectangle, con una altura y un ancho de tres celdas.	Neighborhood
statistics_type (Opcional)	Especifica el tipo de estadística que se calculará. El cálculo se realiza sobre los valores del campo especificado de los puntos que se encuentren dentro la vecindad especificada de cada celda de ráster de salida. MEAN—Se calculará el promedio de los valores de campo en cada vecindad. MAJORITY—Se identificará el valor de campo que ocurre con mayor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior. MAXIMUM—Se identificará el valor de campo más grande en cada vecindad. MEDIAN—Se calculará el valor del campo mediano en cada vecindad. En el caso de que haya un número par de puntos en la vecindad, el resultado será el menor de los dos valores medios. MINIMUM—Se identificará el valor de campo más pequeño en cada vecindad. MINORITY—Se identificará el valor de campo que ocurre con menor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior. RANGE—Se calculará el rango (la diferencia entre los valores más grande y más pequeño) de los valores de campo en cada vecindad. STD—Se calculará la desviación estándar de los valores de campo en cada vecindad. SUM—Se calculará la suma de los valores de campo en la vecindad. VARIETY—Se calculará la cantidad de valores de campo únicos en cada vecindad. El tipo de estadísticas por defecto es MEAN. Las opciones disponibles para el tipo de estadística vienen determinadas por el tipo numérico del campo especificado. Si el campo es de tipo entero, están disponibles todos los tipos de estadísticas. Si el campo es de punto flotante, solo estarán disponibles los tipos de estadísticas máximo, valor medio, mínimo, rango, desviación estándar y suma.	String

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de estadísticas de punto de salida.	Raster

Muestra de código

Ejemplo 1 de PointStatistics (ventana de Python)

Este ejemplo determina una estadística (la suma) de las entidades de punto de un shapefile de entrada que caen en una vecindad circular alrededor de cada celda ráster de salida.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500, 
                                NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")

Ejemplo 2 de PointStatistics (secuencia de comandos independiente)

Este ejemplo determina una estadística (el promedio) de las entidades de punto de un shapefile de entrada que caen en una vecindad circular alrededor de cada celda de ráster de salida.

# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified 
#    neighborhood outputting a 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
inPointFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

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, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

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