Densidad de línea (Spatial Analyst)
Resumen
Calcula una magnitud por unidad de área a partir de entidades de polilínea que caen dentro de un radio alrededor de cada celda.
Uso
-
Sólo la parte de una línea dentro de la vecindad se considera para calcular la densidad. Si no cae ninguna línea dentro de la vecindad de una celda en particular, se asigna NoData a esa celda.
-
Los valores superiores del parámetro del radio producen un ráster de densidad más generalizado. Los valores inferiores producen un ráster que muestra más detalles.
-
Si las unidades del factor de escala de la unidad de área son pequeñas en relación con las entidades (longitud de secciones de línea), los valores de salida pueden ser pequeños. Para obtener valores superiores utilice el factor de escala de unidades (por ejemplo, kilómetros cuadrados frente a metros cuadrados).
-
Los valores del ráster de salida siempre serán de punto flotante.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_polyline_features |
Las entidades de línea de entrada para las que se calculará la densidad. | Feature Layer |
population_field |
Campo numérico que denota los valores de población (la cantidad de veces que debe contarse la línea) para cada polilínea. Los valores del campo de población pueden ser enteros o de punto flotante. A continuación se enumeran las opciones y los comportamientos predeterminados para los campos.
| Field |
cell_size (Opcional) | El tamaño de celda para el dataset ráster de salida. Este es el valor del entorno si se lo establece específicamente. Si el entorno no se establece, entonces el tamańo de celda es menor que el ancho o la altura de la extensión de la salida en la referencia espacial de la salida, dividido entre 250. | Analysis Cell Size |
search_radius (Opcional) |
The search radius within which to calculate density. Las unidades están basadas en la unidad lineal de la proyección de la referencia espacial de salida. Por ejemplo, si las unidades están expresadas en metros, para incluir a todas las entidades dentro de una vecindad de una milla, establezca el radio de búsqueda como 1609,344 (1 milla = 1609,344 metros). El valor predeterminado es el menor del ancho o de la altura de la extensión de la salida en la referencia espacial de la salida, divido entre 30. | Double |
area_unit_scale_factor (Opcional) |
Las unidades de área deseadas de los valores de densidad de salida. Una unidad predeterminada se selecciona según la unidad lineal de la proyección de la referencia espacial de salida. Puede cambiarla a la unidad adecuada si desea convertir la salida de densidad. Los valores de la densidad de línea convierten las unidades de longitud y área. Por ejemplo, si las unidades de entrada son metros, las unidades de densidad de área de salida predeterminadas serán kilómetros cuadrados para las entidades de punto o kilómetros por kilómetros cuadrados para las entidades de polilínea. Las unidades de densidad predeterminadas basadas en las unidades de entidad de entrada son:
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de densidad de línea de salida. Siempre es un ráster de punto flotante. | Raster |
Ejemplo de código
En este ejemplo se calcula un ráster de densidad en un campo de longitud de un archivo de forma de polilínea.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLDens = LineDensity("roads.shp", "LENGTH", 45, 1000, "SQUARE_MILES")
outLDens.save("C:/sapyexamples/output/ldensout")
En este ejemplo se calcula un ráster de densidad en un campo de longitud de un archivo de forma de polilínea.
# Name: LineDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from polyline features
# that fall within a radius around each cell.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPolylineFeatures = "roads.shp"
populationField = "length"
cellSize = 120
searchRadius = 1500
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
searchRadius, "SQUARE_MILES")
# Save the output
outLineDensity.save("C:/sapyexamples/output/linedensity")