Calcular densidad (GeoAnalytics Desktop)

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 funcionan los periodos de tiempo

Ilustración

Ilustración de la herramienta Calcular densidad

Uso

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

    Bins hexagonales y cuadrados

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

  • 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 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 campoDescripció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_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 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 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 su ArcGIS GeoAnalytics Server para realizar un análisis, consulte GeoAnalytics Tools.

  • Se puede completar un análisis similar usando lo siguiente:

Parámetros

EtiquetaExplicaciónTipo 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.

  • CuadradoLa forma de bin será cuadrada. Esta es la opción predeterminada.
  • HexágonoLa forma de bin será hexagonal.
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 aplicará a la función de densidad.

  • UniformeSe 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.
  • KernelSe 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 internacionalesLas unidades de área serán acres internacionales.
  • HectáreasLas unidades de área serán hectáreas.
  • Millas terrestres cuadradasLas unidades de área serán millas terrestres cuadradas.
  • Kilómetros cuadradosLas unidades de área serán kilómetros cuadrados.
  • Metros cuadradosLas unidades de área serán metros cuadrados.
  • Pies cuadrados internacionalesLas unidades de área serán pies cuadrados internacionales.
  • Yardas cuadradas internacionalesLas 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

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

  • SQUARELa forma de bin será cuadrada. Esta es la opción predeterminada.
  • HEXAGONLa forma de bin será hexagonal.
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 aplicará a la función de densidad.

  • UNIFORMSe 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.
  • KERNELSe 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.

  • ACRESLas unidades de área serán acres internacionales.
  • HECTARESLas unidades de área serán hectáreas.
  • SQUARE_MILESLas unidades de área serán millas terrestres cuadradas.
  • SQUARE_KILOMETERSLas unidades de área serán kilómetros cuadrados.
  • SQUARE_METERSLas unidades de área serán metros cuadrados.
  • SQUARE_FEETLas unidades de área serán pies cuadrados.
  • SQUARE_YARDSLas unidades de área serán yardas cuadradas.
  • SQUARE_MILES_USLas unidades de área serán millas cuadradas de agrimensura de EE. UU.
  • SQUARE_FEET_USLas unidades de área serán pies cuadrados de agrimensura de EE. UU.
  • SQUARE_YARDS_USLas unidades de área serán yardas cuadradas de agrimensura de EE. UU.
  • ACRES_USLas 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

Muestra de código

Ejemplo de CalculateDensity (script independiente)

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 an .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.management.MakeFeatureLayer(inputLyrx, "outbreaks_layer")

# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(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"


# Run Calculate Density
arcpy.gapro.CalculateDensity(outbreaksLayer, out, 'HEXAGON', binSize, 
                             'UNIFORM', neighborhoodSize, fields, 
                             'SQUARE_KILOMETERS', timeStepInterval)

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Sí

Temas relacionados