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

  • El Tamaño de celda de salida 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 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 a la referencia espacial de salida, se proyecta en función del Método de proyección de tamaño de celda seleccionado.

  • Cuando el campo especificado es un entero, las opciones de estadística de superposición disponibles son Valor medio, Mayoría, Máximo, Mediana, Mínimo, Minoría, Rango, Desviación estándar, Suma y Variedad. Cuando el campo es de punto flotante, las únicas estadísticas permitidas son Valor medio, Máximo, Mínimo, Rango, Desviación estándar y Suma.

  • Para los tipos de estadísticas Mayoría, Máximo, Mediana, Mínimo, Minoría, Rango y Suma, el tipo de datos de salida del ráster será el mismo que el tipo de campo de entrada. Para los tipos de estadísticas Valor medio y Desviación estándar, el ráster de salida siempre será de punto flotante. Para Variedad, el ráster de salida siempre será un entero.

  • Si no hay puntos 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.

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

Sintaxis

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
ParámetroExplicaciónTipo de datos
in_point_features

Las entidades de punto de entrada para las cuales calcular las estadísticas en una vecindad alrededor de cada celda de salida.

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 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)

La clase de Neighborhood indica la forma del área alrededor de cada punto de entrada utilizado para calcular la estadística.

Los tipos de vecindad disponibles son NbrAnnulus, NbrCircle, NbrRectangle, y NbrWedge.

A continuación, se presentan las formas de vecindad:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

La vecindad predeterminada es un cuadrado NbrRectangle con un ancho y una altura 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 la entrada de punto en la vecindad de cada celda de ráster de salida.

  • MEANCalcula el promedio de los valores de campo en cada vecindad.
  • MAJORITYDetermina el valor de campo que ocurre con mayor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior.
  • MAXIMUMDetermina el valor de campo más grande en cada vecindad.
  • MEDIANDetermina 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.
  • MINIMUMDetermina el valor de campo más pequeño en cada vecindad.
  • MINORITYDetermina el valor de campo que ocurre con menor frecuencia en cada vecindad. En el caso de coincidencias se utilizará el valor inferior.
  • RANGECalcula el rango (diferencia entre los valores más grande y más pequeño) de los valores de campo en cada vecindad.
  • STDCalcula la desviación estándar de los valores de campo en cada vecindad.
  • SUMCalcula el total de los valores de campo en cada vecindad.
  • VARIETYCalcula la cantidad de valores de campo únicos en cada vecindad.

Las opciones disponibles para el tipo de estadística vienen determinadas por el tipo numérico del campo especificado.

String

Valor de retorno

NombreExplicaciónTipo 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")

Información de licenciamiento

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

Temas relacionados