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

Uso

• Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise que tiene un ArcGIS Image Server configurado para Raster Analysis . 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ámetro	Explicación	Tipo 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 Meters —Calcule la densidad por metro cuadrado. Esta es la opción predeterminada. Square Kilometers —Calcule la densidad por kilómetro cuadrado. Square Feet —Calcule la densidad por pie cuadrado. Square Miles —Calcule 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

Nombre	Explicación	Tipo 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)

Entornos

Extensión, Tamaño de celda, Máscara, Sistema de coordenadas de salida, Ráster de alineación

Información de licenciamiento

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