Densidad de puntos (Spatial Analyst)

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.

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

Ilustración

Ilustración de Densidad de puntos
OutRas = PointDensity(InPts, None, 30)

Uso

  • Sólo los puntos que caen dentro de la vecindad se tienen en cuenta 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.

  • Los valores del ráster de salida siempre serán de punto flotante.

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

  • Los valores superiores del parámetro de radio producen un ráster de densidad más generalizado. Los valores inferiores producen un ráster que muestra más detalles.

  • Para los formatos de datos que admiten valores nulos, como las clases de entidad de geodatabase de archivos, se ignorará un valor nulo cuando se utilice como entrada.

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

  • 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

EtiquetaExplicaciónTipo de datos
Entidades de puntos de entrada

Las entidades de puntos de entrada para las que se calculará la densidad.

Feature Layer
Campo de población

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 el campo Shape si las entidades de entrada contienen valores z.

  • De lo contrario, el campo predeterminado es POPULATION. Además, pueden aplicarse las siguientes condiciones.

    • Si no hay ningún campo POPULATION, pero hay un campo POPULATIONxxxx, este se usará de manera predeterminada. xxxx puede ser cualquier carácter válido, por ejemplo, POPULATION6, POPULATION1974 y POPULATIONROADTYPE.
    • Si no hay ningún campo POPULATION ni POPULATIONxxxx, pero hay un campo POP, el campo POP se usará de manera predeterminada.
    • Si no hay ningún campo POPULATION, POPULATIONxxxx ni POP, pero hay un campo POPxxxx, el campo POPxxxx se usará de manera predeterminada.
    • Si no hay ningún campo POPULATION, POPULATIONxxxx, POP ni POPxxxx, NONE se usará de manera predeterminada.
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)

Indica la forma del área alrededor de cada celda que se utiliza para calcular el valor de densidad.

  • Anillo: una vecindad tipo torus (con forma de dona) definida por un radio interno y externo.
  • Círculo: una vecindad circular con un radio determinado. Esto está predeterminado donde el radio es el más corto del ancho o la altura de la extensión de las entidades de entrada, en la referencia espacial de salida, dividido por 30.
  • Rectángulo: una vecindad rectangular con un ancho y una altura determinados.
  • Porción de círculo: una vecindad en forma de cuña. Una cuña 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 contrario a las agujas del reloj desde el eje x positivo). Se pueden utilizar ángulos negativos.
  • Celda | Mapa: define las unidades de las mediciones seleccionadas de la vecindad ya sea en celdas o en unidades de mapa (según la unidad lineal de la proyección de la referencia espacial de salida).
Neighborhood
Unidades de área
(Opcional)

Unidades de área 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 para 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, 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 Kilómetros cuadrados 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 Millas cuadradas.

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 Unidades de mapa cuadradas. 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 Unidades de mapa cuadradas, lo que dará 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 Unidades de mapa cuadradas, lo que dará como resultado kilómetros cuadrados.

A continuación, se indican las opciones disponibles y las unidades de densidad de salida correspondientes:

  • Unidades de mapa cuadradasPara el cuadrado de las unidades lineales de la referencia espacial de salida.
  • Millas cuadradasPara millas (EE. UU.).
  • Kilómetros cuadradosPara kilómetros.
  • AcresPara acres (EE. UU.).
  • HectáreasPara hectáreas.
  • Yardas cuadradasPara yardas (EE. UU.).
  • Pies cuadradosPara pies (EE. UU.).
  • Pulgadas cuadradasPara pulgadas (EE. UU.).
  • Metros cuadradosPara metros.
  • Centímetros cuadradosPara centímetros.
  • Milímetros cuadradosPara milímetros.
String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de densidad de punto de salida.

Siempre es un ráster de punto flotante.

Raster

PointDensity(in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
NombreExplicaciónTipo 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 el campo Shape si las entidades de entrada contienen valores z.

  • De lo contrario, el campo predeterminado es POPULATION. Además, pueden aplicarse las siguientes condiciones.

    • Si no hay ningún campo POPULATION, pero hay un campo POPULATIONxxxx, este se usará de manera predeterminada. xxxx puede ser cualquier carácter válido, por ejemplo, POPULATION6, POPULATION1974 y POPULATIONROADTYPE.
    • Si no hay ningún campo POPULATION ni POPULATIONxxxx, pero hay un campo POP, el campo POP se usará de manera predeterminada.
    • Si no hay ningún campo POPULATION, POPULATIONxxxx ni POP, pero hay un campo POPxxxx, el campo POPxxxx se usará de manera predeterminada.
    • Si no hay ningún campo POPULATION, POPULATIONxxxx, POP ni POPxxxx, NONE se usará de manera predeterminada.
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)

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 y NbrWedge.

Las formas y las descripciones de las clases son:

  • NbrAnnulus ({innerRadius}, {outerRadius}, {units})

    Una vecindad tipo torus (con forma de dona) definida por un radio interno y un radio externo.

  • NbrCircle ({radius}, {units})

    Una vecindad circular con un radio determinado.

  • NbrRectangle ({width}, {height}, {units})

    Una vecindad rectangular con un ancho y una altura determinados.

  • NbrWedge ({radius}, {startAngle}, {endAngle}, {units})

    Una vecindad con forma de cuña (gráfico circular). Una cuña 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 contrario a las agujas del reloj desde el eje x positivo). Se pueden utilizar ángulos negativos.

  • {units}

    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 más corto del ancho o de la altura de la extensión de salida en la referencia espacial de salida, divido entre 30.

Neighborhood
area_unit_scale_factor
(Opcional)

Unidades de área 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 para 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, 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 Kilómetros cuadrados 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 Millas cuadradas.

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 Unidades de mapa cuadradas. 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 Unidades de mapa cuadradas, lo que dará 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 Unidades de mapa cuadradas, lo que dará como resultado kilómetros cuadrados.

A continuación, se indican las opciones disponibles y las unidades de densidad de salida correspondientes:

  • SQUARE_MAP_UNITSPara el cuadrado de las unidades lineales de la referencia espacial de salida.
  • SQUARE_MILESPara millas (EE. UU.).
  • SQUARE_KILOMETERSPara kilómetros.
  • ACRESPara acres (EE. UU.).
  • HECTARESPara hectáreas.
  • SQUARE_YARDSPara yardas (EE. UU.).
  • SQUARE_FEETPara pies (EE. UU.).
  • SQUARE_INCHESPara pulgadas (EE. UU.).
  • SQUARE_METERSPara metros.
  • SQUARE_CENTIMETERSPara centímetros.
  • SQUARE_MILLIMETERSPara milímetros.
String

Valor de retorno

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

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")