Calcular densidad (Análisis ráster)

Resumen

Crea un mapa de densidad a partir de entidades de punto o de línea mediante la distribución de cantidades conocidas de algún fenómeno (representado como atributos de los puntos o las líneas) a todo el mapa. El resultado es una capa de áreas clasificadas de menor a mayor densidad.

Se puede usar una barrera para alterar la influencia de una entidad mientras calcula la densidad.

Ilustración

Ilustración de la herramienta Calcular densidad

Uso

  • Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

    La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

  • Los valores superiores del parámetro del radio producen un ráster de densidad más suave. Los valores inferiores producen un ráster que cambia de una forma más abrupta. Si no se proporciona ningún valor, la herramienta calculará uno en función del número de puntos y sus coordenadas.

  • Solo los puntos o las partes de una línea que caen dentro de la vecindad se consideran en el cálculo de la densidad. Si no hay ningún punto o sección de línea dentro de la vecindad de una celda, la densidad de esa celda será cero.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de puntos o líneas de entrada

Entidades de puntos o líneas de entrada que se utilizarán para calcular el ráster de densidad.

Feature Set
Nombre de salida

Nombre del servicio ráster de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
Campo contar
(Opcional)

Un campo que especifica el número de incidentes de cada ubicación. Por ejemplo, si desea crear un ráster de densidad de población y los puntos de entrada son ciudades, es adecuado usar la población de la ciudad para el campo de recuento con el fin de que las ciudades con poblaciones más grandes tengan un impacto mayor en los cálculos de densidad.

Field
Distancia de búsqueda
(Opcional)

La distancia de búsqueda y unidades para la distancia. Cuando se calcula la densidad de una celda, todas las entidades que se encuentren dentro de esa distancia se utilizarán en el cálculo de densidad de dicha celda.

Las unidades pueden ser kilómetros, metros, millas o pies.

La unidad predeterminada es el metro.

Linear Unit
Unidades de área de salida
(Opcional)

Especifica la unidad que se usará para el cálculo del área. La densidad es el recuento dividido por el área, y este parámetro define las unidades del área en el cálculo de densidad.

  • Metros cuadradosCalcule la densidad por metro cuadrado. Esta es la opción predeterminada.
  • Kilómetros cuadradosCalcule la densidad por kilómetro cuadrado.
  • Pies cuadradosCalcule la densidad por pie cuadrado.
  • Millas cuadradasCalcule la densidad por milla cuadrada.
String
Tamaño de celda de salida
(Opcional)

El tamaño de celda y las unidades para el ráster de salida.

Las unidades pueden ser kilómetros, metros, millas o pies.

La unidad predeterminada es el metro.

Linear Unit
Entidades de barrera de entrada
(Opcional)

El dataset que define las barreras.

La barreras pueden ser una capa de entidades de polígono o polilínea.

Feature Set

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Raster Layer

arcpy.ra.CalculateDensity(inputPointOrLineFeatures, outputName, {countField}, {searchDistance}, {outputAreaUnits}, {outputCellSize}, {inBarriers})
NombreExplicaciónTipo de datos
inputPointOrLineFeatures

Entidades de puntos o líneas de entrada que se utilizarán para calcular el ráster de densidad.

Feature Set
outputName

Nombre del servicio ráster de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
countField
(Opcional)

Un campo que especifica el número de incidentes de cada ubicación. Por ejemplo, si desea crear un ráster de densidad de población y los puntos de entrada son ciudades, es adecuado usar la población de la ciudad para el campo de recuento con el fin de que las ciudades con poblaciones más grandes tengan un impacto mayor en los cálculos de densidad.

Field
searchDistance
(Opcional)

La distancia de búsqueda y unidades para la distancia. Cuando se calcula la densidad de una celda, todas las entidades que se encuentren dentro de esa distancia se utilizarán en el cálculo de densidad de dicha celda.

Las unidades pueden ser kilómetros, metros, millas o pies.

La unidad predeterminada es el metro.

Linear Unit
outputAreaUnits
(Opcional)

Especifica la unidad que se usará para el cálculo del área. La densidad es el recuento dividido por el área, y este parámetro define las unidades del área en el cálculo de densidad.

  • Square MetersCalcule la densidad por metro cuadrado. Esta es la opción predeterminada.
  • Square KilometersCalcule la densidad por kilómetro cuadrado.
  • Square FeetCalcule la densidad por pie cuadrado.
  • Square MilesCalcule la densidad por milla cuadrada.
String
outputCellSize
(Opcional)

El tamaño de celda y las unidades para el ráster de salida.

Las unidades pueden ser kilómetros, metros, millas o pies.

La unidad predeterminada es el metro.

Linear Unit
inBarriers
(Opcional)

El dataset que define las barreras.

La barreras pueden ser una capa de entidades de polígono o polilínea.

Feature Set

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de salida.

Raster Layer

Muestra de código

Ejemplo 1 de CalculateDensity (ventana de Python)

En este ejemplo se crea un ráster de servicio de imágenes de densidad a partir de puntos con un campo de población.

import arcpy

arcpy.ra.CalculateDensity('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                          'outImgServ', 'Population','150000 Meters', 'Square Kilometers','10000 Meters', 
                          'https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/1')
Ejemplo 2 de CalculateDensity (script independiente)

En este ejemplo se crea un ráster de servicio de imágenes de densidad a partir de puntos con un campo de población.

#-------------------------------------------------------------------------------
# Name: CalculateDensity_example02.py
# Description: Creates a density image service raster from points with a population.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inPoints = 'https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0'
outRaster = 'outImgServ'
inField = 'Population'
searchDistance = '150000 Meters'
areaUnit = 'Square Kilometers'
outCellSize = '10000 Meters'
inBarriers = 'https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/1'

# Execute CalculateDensity
arcpy.ra.CalculateDensity(inPoints, outRaster, inField, searchDistance, areaUnit, outCellSize, inBarriers)

Información de licenciamiento

  • Basic: Requiere ArcGIS Image Server
  • Standard: Requiere ArcGIS Image Server
  • Advanced: Requiere ArcGIS Image Server

Temas relacionados