Disponible con una licencia de Spatial Analyst.
Resumen
Calcula una magnitud por unidad de área desde entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.
Ilustración
Uso
Los valores superiores del parámetro del radio producen un ráster de densidad más generalizado. Los valores inferiores producen un ráster que muestra más detalles.
Sólo los puntos que caen dentro de la vecindad se consideran para calcular la densidad. Si no cae ningún punto dentro de la vecindad de una celda en particular, se asigna NoData a esa celda.
Si las unidades del factor de escala de la unidad de área son pequeñas en relación con la distancia entre los puntos, los valores del ráster de salida pueden ser pequeños. Para obtener valores superiores utilice el factor de escala de unidades (por ejemplo, kilómetros cuadrados frente a metros cuadrados).
Los valores del ráster de salida siempre serán de punto flotante.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
PointDensity (in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})| Parámetro | Explicación | Tipo de datos |
in_point_features | Las entidades de puntos de entrada para las que se calculará la densidad. | Feature Layer |
population_field | Campo que denota los valores de población para cada punto. El campo de población es el conteo o la cantidad que se utilizará en el cálculo de una superficie continua. Los valores del campo de población pueden ser enteros o de punto flotante. A continuación se enumeran las opciones y los comportamientos predeterminados para los campos.
| Field |
cell_size (Opcional) | El tamaño de celda para el dataset ráster de salida. Este es el valor del entorno si se lo establece específicamente. Si el entorno no se establece, entonces el tamaÅ„o de celda es menor que el ancho o la altura de la extensión de la salida en la referencia espacial de la salida, dividido entre 250. | Analysis Cell Size |
neighborhood (Opcional) | Indica la forma del área alrededor de cada celda utilizada para calcular el valor de densidad. Esta es una clase de Neighborhood. Hay cuatro tipos de clase de vecindad: NbrAnnulus, NbrCircle, NbrRectangle, and NbrWedge. Las formas y las descripciones de las clases son:
El valor predeterminado es NbrCircle, donde radius es el más corto del ancho o de la altura de la extensión de la salida en la referencia espacial de la salida, divido entre 30. | Neighborhood |
area_unit_scale_factor (Opcional) | Las unidades de área deseadas de los valores de densidad de salida. Una unidad predeterminada se selecciona según la unidad lineal de la referencia espacial de salida. Puede cambiarla a la unidad adecuada si desea convertir la salida de densidad. Los valores de la densidad de línea convierten las unidades de longitud y área. Si no se especifica ninguna referencia espacial de salida, esta será la misma que la clase de entidad de entrada. Las unidades de densidad de salida predeterminadas se determinan mediante las unidades lineales de la referencia espacial de salida, tal y como se indica a continuación. Si las unidades lineales de salida están expresadas en metros, las unidades de densidad de área de salida se establecerán en SQUARE_KILOMETERS para las entidades de punto o en kilómetros por kilómetros cuadrados para las entidades de polilínea. Si las unidades lineales de salida están expresadas en pies, las unidades de densidad de área de salida se establecerán en SQUARE_MILES. Si las unidades de salida están expresadas en otra unidad distinta de pies o metros, las unidades de densidad de área de salida se establecerán en SQUARE_MAP_UNITS. Esto significa que las unidades de densidad de salida corresponderán a la parte cuadrada de las unidades lineales de la referencia espacial de salida. Por ejemplo, si las unidades lineales de salida están expresadas en centímetros, las unidades de densidad de área de salida serán SQUARE_MAP_UNITS, lo que daría como resultado centímetros cuadrados. Si las unidades lineales de salida están expresadas en kilómetros, las unidades de densidad de área de salida serán SQUARE_MAP_UNITS, lo que daría como resultado kilómetros cuadrados. A continuación se indican las opciones disponibles y las unidades de densidad de salida correspondientes:
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | El ráster de densidad de punto de salida. Siempre es un ráster de punto flotante. | Raster |
Muestra de código
Ejemplo 1 de PointDensity (ventana de Python)
En este ejemplo se calcula un ráster de densidad a partir de un archivo de forma de puntos.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
Ejemplo 2 de PointDensity (secuencia de comandos independiente)
En este ejemplo se calcula un ráster de densidad a partir de un archivo de forma de puntos.
# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point
# features that fall within a neighborhood around each cell.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60
# Create the Neighborhood Object
radius = 2500
myNbrCirc = NbrCircle(radius, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize,
myNbrCirc, "SQUARE_KILOMETERS")
# Save the output
outPdens.save("C:/sapyexamples/output/outpdens")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Análisis espacial
- ArcGIS Desktop Standard: Requiere Análisis espacial
- ArcGIS Desktop Advanced: Requiere Análisis espacial