Solo los puntos que se encuentran dentro de la vecindad se tienen en cuenta en el cálculo de la densidad. Si no hay puntos dentro de la vecindad en una celda concreta, a esa celda se le asigna NoData.
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 obtener 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 Alinear ráster, se utiliza el tamaño de celda del ráster de alineación. Si no se especifica ningún valor, el tamaño de celda se calcula a partir del valor más pequeño de anchura o altura de la extensión dividido por 250 en el que la extensión se encuentra en el sistema de coordenadas de salida especificado en el entorno.
Si el tamaño de celda se especifica mediante un valor numérico, la herramienta lo utilizará directamente para el ráster de salida.
Si el tamaño de celda se especifica utilizando un dataset ráster, el parámetro mostrará 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 utilizará 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 de la referencia espacial de salida, se proyecta en función del valor Método de proyección de tamaño de celda especificado.
Los valores superiores del parámetro del radio producen un ráster de densidad más generalizada. 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 entidades 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, el ráster de salida puede ser pequeños. Para obtener valores más elevados, utilice el factor de escala de unidades de superficie para unidades más grandes (por ejemplo, kilómetros cuadrados frente a metros cuadrados).
Entidades de punto de entrada para las que se calculará la densidad.
Feature Layer
Campo de población
El campo que indica los valores de población para cada punto. El campo de población es el recuento 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 NONE si no se utilizará ningún elemento ni valor especial y cada entidad se contará una sola vez.
Puede utilizar 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 POPULATIONabcd, este se usará de manera predeterminada. El abcd puede ser cualquier carácter válido, por ejemplo, POPULATION6, POPULATION1974 o POPULATIONROADTYPE.
Si no hay un campo POPULATION o POPULATIONabcd, pero sí hay un campo POP, el campo POP se utilizará de forma predeterminada.
Si no hay un campo POPULATION, POPULATIONabcd o POP, pero hay un campo POPabcd, el campo POPabcd se utilizará de forma predeterminada.
Si no hay ningún campo POPULATION, POPULATIONabcd, POP ni POPabcd, NONE se usará de forma predeterminada.
Field
Tamaño de celda de salida
(Opcional)
Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.
Analysis Cell Size
Vecindario
(Opcional)
Indica la forma del área alrededor de cada celda utilizada para calcular el valor de densidad.
Annulus—Una vecindad tipo torus (con forma de dona) definida por un radio interno y externo.
Circle—Una vecindad circular con un radio determinado. Esta es la opción predeterminada en que el radio 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.
Rectangle—Vecindad rectangular con la altura y el ancho especificados.
Wedge—Vecindad en forma de cuña. Una cuña se especifica mediante un ángulo inicial, un ángulo final 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 sentido antihorario desde el eje x positivo). Se pueden utilizar ángulos negativos.
Cell | Map—Define las unidades de las mediciones de vecindad seleccionadas en celdas o unidades de mapa (basadas en la unidad lineal de la proyección de la referencia espacial de salida).
Neighborhood
Unidades de área
(Opcional)
Especifica las unidades de área que se utilizarán para los valores de densidad de salida.
Se determina una unidad predeterminada en función de 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 están determinadas por las unidades lineales de la referencia espacial de salida. 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, lo que dará como resultado kilómetros cuadrados para las entidades de punto. 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 cuadradas—Se utilizará el cuadrado de las unidades lineales de la referencia espacial de salida.
Millas cuadradas—Se utilizarán las millas de EE. UU.
Kilómetros cuadrados—Se utilizarán los kilómetros.
Acres—Se utilizarán los acres de EE. UU.
Hectáreas—Se utilizarán las hectáreas.
Yardas cuadradas—Se utilizarán las yardas de EE. UU.
Pies cuadrados—Se utilizarán los pies de EE. UU.
Pulgadas cuadradas—Se utilizarán las pulgadas de EE. UU.
Metros cuadrados—Se utilizarán los metros.
Centímetros cuadrados—Se utilizarán los centímetros.
Milímetros cuadrados—Se utilizarán los milímetros.
Entidades de punto de entrada para las que se calculará la densidad.
Feature Layer
population_field
El campo que indica los valores de población para cada punto. El campo de población es el recuento 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 NONE si no se utilizará ningún elemento ni valor especial y cada entidad se contará una sola vez.
Puede utilizar 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 POPULATIONabcd, este se usará de manera predeterminada. El abcd puede ser cualquier carácter válido, por ejemplo, POPULATION6, POPULATION1974 o POPULATIONROADTYPE.
Si no hay un campo POPULATION o POPULATIONabcd, pero sí hay un campo POP, el campo POP se utilizará de forma predeterminada.
Si no hay un campo POPULATION, POPULATIONabcd o POP, pero hay un campo POPabcd, el campo POPabcd se utilizará de forma predeterminada.
Si no hay ningún campo POPULATION, POPULATIONabcd, POP ni POPabcd, NONE se usará de forma predeterminada.
Field
cell_size
(Opcional)
Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.
Analysis Cell Size
neighborhood
(Opcional)
Indica la forma del área alrededor de cada celda utilizada para calcular el valor de densidad.
Una vecindad en forma de cuña (pastel). Una cuña se especifica mediante un ángulo inicial, un ángulo final 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 sentido antihorario desde el eje x positivo). Se pueden utilizar ángulos negativos.
{units}
Define las unidades como número de celdas o como valor en unidades de mapa.
El valor predeterminado es NbrCircle, donde radius es el menor 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)
Especifica las unidades de área que se utilizarán para los valores de densidad de salida.
Se determina una unidad predeterminada en función de la unidad lineal de la referencia espacial de salida. Puede cambiarla a la unidad adecuada para convertir la salida de densidad.
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 están determinadas por las unidades lineales de la referencia espacial de salida. 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, lo que dará como resultado kilómetros cuadrados para las entidades de punto. 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á 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á como resultado kilómetros cuadrados.
A continuación, se indican las opciones disponibles y las unidades de densidad de salida correspondientes:
SQUARE_MAP_UNITS—Se utilizará el cuadrado de las unidades lineales de la referencia espacial de salida.
SQUARE_MILES—Se utilizarán las millas de EE. UU.
SQUARE_KILOMETERS—Se utilizarán los kilómetros.
ACRES—Se utilizarán los acres de EE. UU.
HECTARES—Se utilizarán las hectáreas.
SQUARE_YARDS—Se utilizarán las yardas de EE. UU.
SQUARE_FEET—Se utilizarán los pies de EE. UU.
SQUARE_INCHES—Se utilizarán las pulgadas de EE. UU.
SQUARE_METERS—Se utilizarán los metros.
SQUARE_CENTIMETERS—Se utilizarán los centímetros.
SQUARE_MILLIMETERS—Se utilizarán los milímetros.
String
Valor de retorno
Nombre
Explicación
Tipo de datos
out_raster
Ráster de densidad de puntos de salida
Siempre es un ráster de punto flotante.
Raster
Muestra de código
PointDensity ejemplo 1 (ventana de Python)
Este ejemplo calcula un ráster de densidad a partir de un shapefile de puntos.
Este ejemplo calcula un ráster de densidad a partir de un shapefile 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")
# Run PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize,
myNbrCirc, "SQUARE_KILOMETERS")
# Save the output
outPdens.save("C:/sapyexamples/output/outpdens")
