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.
Ilustración
Uso
En una entrada de punto, cada punto debe representar la ubicación de un evento o un incidente, y la capa de resultados representa un recuento del incidente por unidad de área. Un valor más alto de la densidad en una nueva ubicación significa que hay más puntos cerca de esa ubicación. En muchos casos, la capa de resultados se puede interpretar como una superficie de riesgo para eventos futuros. Por ejemplo, si los puntos de entrada representan ubicaciones en las que ha caído un rayo, la capa de resultados se puede interpretar como una superficie de riesgo para la caída de rayos en el futuro.
En el caso de la entrada de línea, la superficie de densidad de línea representa la cantidad total de la línea que está cerca de cada ubicación. Las unidades de los valores de densidad calculados corresponden a la longitud de línea por unidad de área. Por ejemplo, si las líneas representan ríos, la capa de resultados representará la longitud total de los ríos que están dentro del radio de búsqueda. Este resultado se puede usar para identificar las áreas que son adecuadas como pastos para animales.
Se describen a continuación otros ejemplos de uso de esta herramienta:
- Crear mapas de densidad de delitos para ayudar a los departamentos de policía a asignar los recursos adecuados a las zonas con un alto nivel de delitos.
- Calcular las densidades de hospitales en un condado. La capa de resultados mostrará las áreas con una accesibilidad alta y baja a los hospitales, y esta información se puede usar para decidir dónde se deben construir nuevos hospitales.
- Identificar áreas con un alto riesgo de incendio forestal en función del historial de ubicaciones de estos incendios.
- Buscar comunidades alejadas de las principales carreteras para planificar dónde se deben construir nuevas carreteras.
Sintaxis
arcpy.sfa.CalculateDensity(inputLayer, outputName, {field}, {cellSize}, {cellSizeUnits}, {radius}, {radiusUnits}, {boundingPolygonLayer}, {areaUnits}, {classificationType}, {numClasses})
Parámetro | Explicación | Tipo de datos |
inputLayer | Las entidades de punto o de línea a partir de las cuales se puede calcular la densidad. | Feature Set |
outputName | El nombre de la capa de salida que se debe crear en el portal. | String |
field (Opcional) | Un campo que especifica el número de incidentes en cada ubicación. Por ejemplo, si tienes puntos que representan ciudades, puedes usar un campo que represente la población de la ciudad como campo de recuento, y la capa de densidad de población resultante calculará las densidades de población más altas cerca de las ciudades con las mayores poblaciones. Si no se ha especificado, se entenderá que cada ubicación representa un solo recuento. | Field |
cellSize (Opcional) | El valor se usa para crear una malla de puntos en la que se calculan los valores de densidad. El valor predeterminado es aproximadamente 1/1000o de la anchura o la altura (el valor que sea más pequeño) de la extensión del análisis definida en el parámetro de contexto. Cuanto más pequeño sea el valor, más suaves serán los límites del polígono. Por el contrario, con valores más altos, los límites del polígono estarán menos definidos y tendrán una apariencia irregular. | Double |
cellSizeUnits (Opcional) | Las unidades del valor del tamaño de celda. Debe proporcionar un valor si se ha definido el tamaño de celda.
| String |
radius (Opcional) | Una distancia que especifica lo lejos que se debe buscar para encontrar entidades de punto o de línea al calcular valores de densidad. Por ejemplo, si proporciona una distancia de búsqueda de 1800 metros, la densidad de cualquier ubicación de la capa de salida se calcula en función de las entidades situadas a un máximo de 1800 metros de la ubicación. Cualquier ubicación que no tenga ningún incidente a una distancia máxima de 1800 metros recibirá un valor de densidad de cero. Si no se proporciona ninguna distancia, se calculará un valor predeterminado en función de las ubicaciones de las entidades de entrada y los valores del campo de recuento (si se ha proporcionado un campo de recuento). | Double |
radiusUnits (Opcional) | Las unidades del valor del radio. Debe proporcionar un valor si se ha definido un radio.
| String |
boundingPolygonLayer (Opcional) | Una capa que especifica los polígonos en los que se desea que se calculen las densidades. Por ejemplo, si estás interpolando densidades de peces en un lago, puedes usar el límite del lago en este parámetro y la salida solo se dibujará dentro del límite del lago. | Feature Set |
areaUnits (Opcional) | Las unidades de los valores de densidad calculados.
| String |
classificationType (Opcional) | Determina cómo se clasificarán en polígonos los valores de densidad.
| String |
numClasses (Opcional) | Este valor se usa para dividir el rango de valores predichos en distintas clases. El rango de valores de cada clase viene determinado por el tipo de clasificación. Cada clase define los límites de los polígonos resultantes. El valor predeterminado es 10 y el máximo es 32. | Long |
Salida derivada
Nombre | Explicación | Tipo de datos |
outputLayer | La capa de polígonos de salida con valores de densidad clasificados. | Conjunto de entidades |
Entornos
Información de licenciamiento
- Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis