| Etiqueta | Explicación | Tipo de datos |
Capa de entrada | Los puntos que se utilizarán para calcular la densidad. | Feature Layer |
Clase de entidad de salida | Una clase de entidad nueva con densidades calculadas. | Feature Class |
Tipo de bin | Especifica la forma de bin que se usará en el análisis.
| String |
Tamaño de bin | El tamaño de los bins utilizados para agregar las entidades de entrada. Cuando se generan bins para los cuadrados, el número y las unidades especificados determinan la altura y la longitud del cuadrado. Para los hexágonos, son el número y las unidades especificados los que determinan la distancia entre los lados paralelos. | Linear Unit |
Ponderación | Especifica la ponderación que se debe aplicar a la función de densidad.
| String |
Tamaño de vecindad | El radio de búsqueda que se debe aplicar a los cálculos de densidad. | Linear Unit |
Campos (Opcional) | Uno o varios campos que denotan los valores de población para cada entidad. El campo de población es el recuento o la cantidad que se expandirá a lo largo del paisaje para crear una superficie continua. Los valores del campo de población deben ser numéricos. De manera predeterminada, siempre se calculará la densidad del recuento de puntos de entrada. | Field |
Factor de escala de unidad de área (Opcional) | Especifica las unidades de área de los valores de densidad de salida. La unidad predeterminada se basa en las unidades de la referencia espacial de salida.
| String |
Intervalo de periodo de tiempo (Opcional) | Un valor que especifica la duración del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. Los periodos de tiempo solo se pueden aplicar si el tiempo está habilitado en la entrada. | Time Unit |
Repetición de periodo de tiempo (Opcional) | Un valor que especifica la frecuencia con la que se produce el intervalo del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. | Time Unit |
Referencia de periodo de tiempo (Opcional) | Una fecha que especifica el tiempo de referencia con el que se alinearán los períodos de tiempo. El valor predeterminado es el 1 de enero de 1970 a las 12:00 AM. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. | Date |
Resumen
Calcula un área de magnitud por unidad desde entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.
Ilustración
Uso
La herramienta Calcular densidad requiere una única entrada de entidades de puntos.
También es posible calcular la densidad utilizando uno o más campos de recuento. Un campo de recuento es un campo numérico que especifica la cantidad de incidentes en cada ubicación. En algunas entidades como, por ejemplo, ciudades o autopistas, se pueden utilizar un campo de recuento al calcular la densidad de población o carriles de tráfico, respectivamente. Si especifica un campo de recuento, la densidad se calculará para el campo de recuento además de la densidad de puntos.
Los puntos de entrada se consolidan en bins para el análisis. Debe especificar tamaño de bin al que consolidar datos. De forma predeterminada, los resultados de salida estarán en kilómetros cuadrados.
Los puntos de entrada se agregan en bins de un tamaño y forma especificados (hexágono o cuadrado). Si va a agregar a hexágonos, el tamaño de bin d será la altura de cada hexágono y el ancho del hexágono resultante será el doble de la altura dividido entre la raíz cuadrada de tres. Si va a agregar a cuadros, el tamaño de bin d es la altura del cuadrado, que es igual al ancho.
Debe especificar un tamaño de vecindario que sea mayor que el tamaño de bin. El tamaño de vecindario se utiliza para buscar entidades de entrada dentro de la misma vecindad como la entidad (bin) de interés.
Los valores superiores del tamaño de vecindario producen una salida de densidad más generalizada. Los valores inferiores producen una salida que muestra más detalles.
Solo los puntos que se encuentran dentro de una vecindad se tienen en cuenta en el cálculo de la densidad. Si ningún punto se encuentra dentro de la vecindad de una celda, no se asigna un valor a esa celda.
Hay dos opciones de ponderación para calcular la densidad: la opción Uniforme suma todos los valores dentro del vecindario y los divide entre el área. La opción Kernel pondera los valores del vecindario según la distancia desde la entidad de interés y aplica una función kernel para encajar una superficie lisa y cónica en cada punto.
Solo se devolverán las áreas dentro del vecindario de un bin que contengan puntos.
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 de salida pueden ser muy pequeños. Para obtener valores más altos, utilice el factor de escala de unidad de área para unidades más grandes (por ejemplo, use Kilómetros cuadrados en lugar de Metros cuadrados).
El análisis con agrupamiento en bins requiere que la entrada esté proyectada o que el sistema de coordenadas de salida esté establecido como un sistema de coordenadas proyectadas. Si los datos no se encuentran en un sistema de coordenadas proyectadas y no desea establecer ninguno, se usará una proyección en función de la extensión de los datos que está analizando.
Los valores de densidad siempre serán de punto flotante.
Calcular densidad permite analizar opcionalmente utilizando intervalos de tiempo. Cada periodo de tiempo se analiza con independencia de las entidades que quedan fuera de él. Para usar intervalos de tiempo, los datos de entrada deben tener la función de tiempo habilitada y representar un instante en el tiempo. Cuando se aplican intervalos de tiempo, las entidades de salida serán intervalos de tiempo representados por campos.
Cuando las entidades de entrada se analizan usando periodos de tiempo, cada periodo de tiempo se analiza con independencia de las entidades que quedan fuera de él.
El parámetro Referencia de periodo de tiempo puede ser un valor de fecha y hora o simplemente un valor de fecha; no puede ser solo un valor de hora.
En las entidades de salida se incluyen los siguientes campos:
Nombre de campo Description density
La densidad del polígono determinado. Se devuelve en el factor de escala de unidad especificado.
density_<fieldname>
La densidad ponderada por el campo determinado. Tan solo se devuelve cuando se especifican uno o varios campos.
start_date
Cuando se especifican periodos de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de inicio.
end_date
Cuando se especifican periodos de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de finalización.
Es posible mejorar el rendimiento de la herramienta Calcular densidad gracias a una o varias de estas sugerencias:
- Defina el entorno de extensión para analizar únicamente datos de interés.
- Los bins mayores funcionarán mejor que los pequeños. Si no sabe qué tamaño utilizar, comience con un bin mayor como prototipo.
- De forma similar a los bins, los periodos de tiempo mayores funcionan mejor que los menores.
- Disminuya el ratio del tamaño de la vecindad al tamaño del bin. Una vecindad tres veces más grande que un bin funcionará mejor que otra que tenga 10 veces el tamaño del bin.
- Utilice datos locales en los que se ejecute el análisis.
Esta herramienta de geoprocesamiento se basa en Spark. El análisis se completa en su equipo de escritorio utilizando varios núcleos en paralelo. Consulte Consideraciones acerca de las herramientas de GeoAnalytics Desktop para obtener más información acerca de la ejecución de análisis.
Al ejecutar herramientas de GeoAnalytics Desktop, el análisis se completa en su equipo de escritorio. Para un rendimiento óptimo, los datos deben estar disponibles en su escritorio. Si utiliza una capa de entidades alojada, se recomienda utilizar ArcGIS GeoAnalytics Server. Si sus datos no están almacenados localmente, se tardará más tiempo en ejecutar una herramienta. Para utilizar ArcGIS GeoAnalytics Server con el fin de realizar un análisis, consulte GeoAnalytics Tools.
Se puede completar un análisis similar usando lo siguiente:
- Consolidar puntos en la caja de herramientas de GeoAnalytics Desktop o caja de herramientas de GeoAnalytics Server
- La herramienta Densidad de puntos de la caja de herramientas de Spatial Analyst
- La herramienta Densidad kernel de la caja de herramientas de Spatial Analyst
- La herramienta Calcular densidad de la caja de herramientas Análisis de entidades estándar
Parámetros
arcpy.gapro.CalculateDensity(input_layer, out_feature_class, bin_type, bin_size, weight, neighborhood_size, {fields}, {area_unit_scale_factor}, {time_step_interval}, {time_step_repeat}, {time_step_reference})| Nombre | Explicación | Tipo de datos |
input_layer | Los puntos que se utilizarán para calcular la densidad. | Feature Layer |
out_feature_class | Una clase de entidad nueva con densidades calculadas. | Feature Class |
bin_type | Especifica la forma de bin que se usará en el análisis.
| String |
bin_size | El tamaño de los bins utilizados para agregar las entidades de entrada. Cuando se generan bins para los cuadrados, el número y las unidades especificados determinan la altura y la longitud del cuadrado. Para los hexágonos, son el número y las unidades especificados los que determinan la distancia entre los lados paralelos. | Linear Unit |
weight | Especifica la ponderación que se debe aplicar a la función de densidad.
| String |
neighborhood_size | El radio de búsqueda que se debe aplicar a los cálculos de densidad. | Linear Unit |
fields [fields,...] (Opcional) | Uno o varios campos que denotan los valores de población para cada entidad. El campo de población es el recuento o la cantidad que se expandirá a lo largo del paisaje para crear una superficie continua. Los valores del campo de población deben ser numéricos. De manera predeterminada, siempre se calculará la densidad del recuento de puntos de entrada. | Field |
area_unit_scale_factor (Opcional) | Especifica las unidades de área de los valores de densidad de salida. La unidad predeterminada se basa en las unidades de la referencia espacial de salida.
| String |
time_step_interval (Opcional) | Un valor que especifica la duración del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. Los periodos de tiempo solo se pueden aplicar si el tiempo está habilitado en la entrada. | Time Unit |
time_step_repeat (Opcional) | Un valor que especifica la frecuencia con la que se produce el intervalo del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. | Time Unit |
time_step_reference (Opcional) | Una fecha que especifica el tiempo de referencia con el que se alinearán los períodos de tiempo. El valor predeterminado es el 1 de enero de 1970 a las 12:00 AM. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo. | Date |
Muestra de código
El siguiente script independiente muestra cómo utilizar la función CalculateDensity.
# Name: CalculateDensity.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/HealthInfo.gdb"
# Enable time on the input features using a .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\outbreaks.lyrx'
# MakeFeatureLayer converts the .lyrx to features
outbreaksLayer = arcpy.MakeFeatureLayer_management(inputLyrx, "outbreaks_layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.ApplySymbologyFromLayer_management(outbreaksLayer, inputLyrx)
# By default, the count of points will be used in addition to any other fields
# that are specified
fields = "Severity"
# Set the size of bins and neighborhood and the time step size
binSize = "1 Kilometers"
neighborhoodSize = "2 Kilometers"
timeStepInterval = "1 Weeks"
# Specify output info
out = "OutbreakDensity"
# Execute Calculate Density
arcpy.gapro.CalculateDensity(outbreaksLayer, out, 'HEXAGON', binSize,
'UNIFORM', neighborhoodSize, fields,
'SQUARE_KILOMETERS', timeStepInterval)Entornos
Casos especiales
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí