Calcula una magnitud por unidad de área desde entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.
Heredado:
La extensión de ArcGIS GeoAnalytics Server quedará obsoleta en ArcGIS Enterprise. La versión final de GeoAnalytics Server se incluyó con ArcGIS Enterprise 11.3. Esta herramienta de geoprocesamiento está disponible a través de ArcGIS Enterprise 11.3 y versiones anteriores.
La herramienta Calcular densidad requiere una única entrada de entidades de puntos.
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 utilizará para buscar entidades de entrada dentro de la misma vecindad como la entidad (bin) de interés.
Los valores del tamaño de vecindario más grandes 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 tendrán en cuenta en el cálculo de la densidad. Si ningún punto se encuentra dentro de la vecindad de una celda, no se asignará ningún 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).
Calcular densidad requiere que la capa de área esté en un sistema de coordenadas proyectadas. Si los datos no se proyectan y no desea establecer ningún sistema de coordenadas proyectadas, el análisis se completará en la proyección cilíndrica equivalente del mundo (WKID 54034).
Los valores de densidad siempre serán de punto flotante.
Calcular densidad permite analizar utilizando periodos de tiempo. Cada periodo de tiempo se analiza con independencia de las entidades que quedan fuera de él. Para usar periodos 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
Descripción
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_datetime
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_datetime
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 las siguientes acciones:
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 3 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 ArcGIS GeoAnalytics Server. El análisis se completa en GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.
Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.
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
Etiqueta
Explicación
Tipo de datos
Capa de entrada
Los puntos que se utilizarán para calcular la densidad.
Feature Set
Nombre de salida
El nombre del servicio de entidades de salida.
String
Tipo de bin
Especifica la forma de bin que se usará en el análisis.
Cuadrado—La forma de bin será cuadrada. Esta es la opción predeterminada.
Hexágono—La forma de bin será hexagonal.
String
Tamaño de bin
El tamaño de los bins que se utilizarán 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 aplicará a la función de densidad.
Uniforme—Se utilizará un cálculo de magnitud por área en el que se asigna la misma ponderación a cada bin. Esta es la opción predeterminada.
Kernel—Se utilizará un cálculo de magnitud por área que tiene aplicado un algoritmo de suavizado (kernel) que asigna un peso más alto a los bins más cercanos a los puntos.
String
Tamaño de vecindad
El radio de búsqueda que se 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 que se utilizarán para los valores de densidad de salida. La unidad predeterminada se basa en las unidades de la referencia espacial de salida.
Acres internacionales—Las unidades de área serán acres internacionales.
Hectáreas—Las unidades de área serán hectáreas.
Millas terrestres cuadradas—Las unidades de área serán millas terrestres cuadradas.
Kilómetros cuadrados—Las unidades de área serán kilómetros cuadrados.
Metros cuadrados—Las unidades de área serán metros cuadrados.
Pies cuadrados internacionales—Las unidades de área serán pies cuadrados internacionales.
Yardas cuadradas internacionales—Las unidades de área serán yardas cuadradas internacionales.
Millas cuadradas de agrimensura de EE. UU.—Las unidades de área serán millas cuadradas de agrimensura de EE. UU.
Pies cuadrados de agrimensura de EE. UU.—Las unidades de área serán pies cuadrados de agrimensura de EE. UU.
Yardas cuadradas de agrimensura de EE. UU.—Las unidades de área serán yardas cuadradas de agrimensura de EE. UU.
Acres topográficos de EE. UU.—Las unidades de área serán acres topográficos de EE. UU.
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
Data store
(Opcional)
Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.
Big data store espaciotemporal—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
Data store relacional—La salida se almacenará en un data store relacional.
String
Salida derivada
Etiqueta
Explicación
Tipo de datos
Clase de entidad de salida
La magnitud por unidad de área desde entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.
Los puntos que se utilizarán para calcular la densidad.
Feature Set
output_name
El nombre del servicio de entidades de salida.
String
bin_type
Especifica la forma de bin que se usará en el análisis.
SQUARE—La forma de bin será cuadrada. Esta es la opción predeterminada.
HEXAGON—La forma de bin será hexagonal.
String
bin_size
El tamaño de los bins que se utilizarán 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 aplicará a la función de densidad.
UNIFORM—Se utilizará un cálculo de magnitud por área en el que se asigna la misma ponderación a cada bin. Esta es la opción predeterminada.
KERNEL—Se utilizará un cálculo de magnitud por área que tiene aplicado un algoritmo de suavizado (kernel) que asigna un peso más alto a los bins más cercanos a los puntos.
String
neighborhood_size
El radio de búsqueda que se 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 que se utilizarán para los valores de densidad de salida. La unidad predeterminada se basa en las unidades de la referencia espacial de salida.
ACRES—Las unidades de área serán acres internacionales.
HECTARES—Las unidades de área serán hectáreas.
SQUARE_MILES—Las unidades de área serán millas terrestres cuadradas.
SQUARE_KILOMETERS—Las unidades de área serán kilómetros cuadrados.
SQUARE_METERS—Las unidades de área serán metros cuadrados.
SQUARE_FEET—Las unidades de área serán pies cuadrados.
SQUARE_YARDS—Las unidades de área serán yardas cuadradas.
SQUARE_MILES_US—Las unidades de área serán millas cuadradas de agrimensura de EE. UU.
SQUARE_FEET_US—Las unidades de área serán pies cuadrados de agrimensura de EE. UU.
SQUARE_YARDS_US—Las unidades de área serán yardas cuadradas de agrimensura de EE. UU.
ACRES_US—Las unidades de área serán acres topográficos de EE. UU.
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
data_store
(Opcional)
Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.
SPATIOTEMPORAL_DATA_STORE—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
RELATIONAL_DATA_STORE—La salida se almacenará en un data store relacional.
String
Salida derivada
Nombre
Explicación
Tipo de datos
output
La magnitud por unidad de área desde entidades de puntos que se encuentran dentro de una vecindad alrededor de cada celda.
Feature Set
Muestra de código
CalculateDensity (ventana de Python)
El siguiente script de la ventana de Python muestra cómo utilizar la función CalculateDensity.
# Name: Calculate Density.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
# This example uses a big data file share name "HealthInfo" with dataset
# "Outbreaks" registered on a GeoAnalytics server
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_HealthInfo/BigDataCatalogServer/Outbreaks"
# 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
outFS = "OutbreakDensity"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Run Calculate Density
arcpy.geoanalytics.CalculateDensity(inFeatures, outFS, 'HEXAGON', binSize,
'UNIFORM', neighborhoodSize, fields,
'SQUARE_KILOMETERS', timeStepInterval, None,
None, dataStore)
El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. En GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.
