Densidad de punto (Spatial Analyst)

Resumen

Calcula una magnitud por unidad de área a partir de entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.

Más información sobre cómo funciona Densidad de punto

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.

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. Use Ninguno si no se utilizará un elemento o valor especial y cada entidad se contará una sola vez. Puede usar la Forma si las entidades de entrada contienen Z. De lo contrario, el campo predeterminado es POPULATION. Además, pueden aplicarse las siguientes condiciones. Si no hay campo de POPULATION, pero hay un campo de POPULATIONxxxx, este se usa de manera predeterminada. "xxxx" puede ser cualquier carácter válido, como POPULATION6, POPULATION1974 o POPULATIONROADTYPE. Si no hay campo de POPULATION o de POPULATIONxxxx, pero hay un campo de POP, este se usa de manera predeterminada. Si no hay campo de POPULATION, de POPULATIONxxxx o de POP, pero hay un campo POPxxxx, este se usa de manera predeterminada. Si no hay campo de POPULATION, de POPULATIONxxxx de POP o de POPxxxx, NONE se usa de manera predeterminada.	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 Vecindad. Hay cuatro tipos de clase de vecindad: NbrAnnulus, NbrCircle, NbrRectangle y NbrWedge. Las formas y las descripciones de las clases son: NbrAnnulus ({inner_radius}, {outer_radius}, {CELL | MAP}) Una vecindad tipo torus (con forma de dona) definida por un radio interno y un radio externo. NbrCircle ({radius}, {CELL | MAP}) Una vecindad circular con un radio determinado. NbrRectangle ({width}, {height}, {CELL | MAP}) Una vecindad rectangular con un ancho y una altura determinados. NbrWedge ({radius}, {start_angle}, {end_angle}, {CELL | MAP}) Una vecindad con forma de porción de círculo (gráfico circular). Una porción de círculo se especifica mediante un ángulo de inicio, un ángulo de finalización y un radio. 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 aritméticos (en el sentido de las agujas del reloj desde el eje x positivo). Se pueden utilizar ángulos negativos. {CELL | MAP} Define las unidades como la cantidad de celdas o como un valor en unidades de mapa. El valor predeterminado es NbrCircle, donde radius es el valor más bajo del ancho o la altura de la extensión de de la salida, en la referencia espacial de salida, dividido por 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 proyección 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. Por ejemplo, si las unidades de entrada son metros, las unidades de densidad de área de salida predeterminadas serán kilómetros cuadrados para las entidades de punto o kilómetros por kilómetros cuadrados para las entidades de polilínea. Las unidades de densidad predeterminadas basadas en las unidades de entidad de entrada son: SQUARE_MAP_UNITS — Si no se conocen las unidades, puntos o grados decimales. SQUARE_MILES — Para pies, yardas, millas o millas náuticas. SQUARE_KILOMETERS — Para metros o kilómetros. SQUARE_INCHES — Para pulgadas. SQUARE_CENTIMETERS — Para centímetros. SQUARE_MILLIMETERS — Para milímetros.	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

Ejemplo 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

Tamaño de celda, Espacio de trabajo actual, Máscara, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal, Alinear ráster

Información de licencia

ArcView: Requiere Análisis espacial

ArcEditor: Requiere Análisis espacial

ArcInfo: Requiere Análisis espacial