Estadísticas de punto (Spatial Analyst)
Resumen
Calcula una estadística de los puntos en una vecindad alrededor de cada celda de salida.
Uso
-
Cuando el campo 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, STD, Suma y Variedad. Cuando el campo es de punto flotante, las únicas estadísticas permitidas son Valor medio, Máximo, Mínimo, Rango, STD 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 STD, el ráster de salida siempre será de punto flotante. Para Variedad, el ráster de salida siempre será un entero.
-
Si no hay ningún punto en la vecindad de una celda ráster, la estadística Variedad le asigna un valor 0. Para las demás estadísticas, se asigna NoData.
Sintaxis
| Parámetro | Explicación | Tipo 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 puede ser cualquier campo numérico de las entidades de puntos de entrada. Puede ser el campo Forma si las entidades de entrada contienen Z. | Field |
cell_size (Opcional) |
Tamaño de celda del dataset ráster de salida. Este es el valor del entorno si se lo establece específicamente. Si no está configurado en el entorno, es el valor más bajo del ancho o la altura de la extensión del dataset de entidades de entrada, en la referencia espacial de salida, dividido por 250. | Analysis Cell Size |
neighborhood (Opcional) |
La clase de Vecindad indica la forma del área alrededor de cada punto de entrada utilizado para calcular la estadística. Los diferentes tipos de vecindad disponibles son NbrAnnulus, NbrCircle, NbrRectangle, y NbrWedge. A continuación, se presentan las formas de vecindad:
El parámetro {CELL | MAP} define las unidades de distancia como unidades de celda o unidades de mapa. La vecindad predeterminada es un NbrRectangle cuadrado de ancho y altura de 3 celdas. | Neighborhood |
statistics_type (Opcional) |
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.
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de estadísticas de punto de salida. | Raster |
Ejemplo de código
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")
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")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
neighborhood, "MEAN")
# Save the output
outPointStatistics.save("C:/sapyexamples/output/pointstatout")