Calcular densidad (Análisis de 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 de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise Enlace a información sobre el análisis en el portal de ArcGIS Enterprise que tiene un ArcGIS Image Server enlace a Qué es ArcGIS Image Server configurado para Raster Analysis Enlace a Configurar e implementar análisis de ráster. Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y tiene lugar el procesamiento 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.

Sintaxis

arcpy.ra.CalculateDensity(inputPointOrLineFeatures, outputName, {countField}, {searchDistance}, {outputAreaUnits}, {outputCellSize}, {inBarriers})
ParámetroExplicació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.

Las barreras pueden ser una capa de entidades poligonales o de polilínea.

Feature Set

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de salida.

Capa ráster

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 (secuencia de comandos 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