Estadísticas de líneas (Spatial Analyst)
Resumen
Calcula una estadística de los atributos de las líneas en una vecindad circular alrededor de cada celda de salida.
Uso
-
Solo la parte de una línea dentro de la vecindad se considera para las estadísticas Mayoría, Valor medio, Mediana y Minoría. Para los demás, no importa si se utiliza una parte o toda la línea.
-
Si no hay líneas en la vecindad de una celda ráster, la estadística Variedad asigna un valor de cero. Para las otras estadísticas, se asigna NoData.
-
Los tipos de estadística Mayoría, Valor medio, Mediana y Minoría se ponderan en relación con la longitud de las líneas. Por ejemplo, si una línea es dos veces más larga que otra, se considera que el valor ocurrirá con el doble de frecuencia.
-
Los valores en el ráster de salida siempre serán enteros en el caso de Variedad. Siempre serán de punto flotante para Valor medio. Para las demás estadísticas, el tipo de datos de salida es el mismo que el tipo de valor del elemento de entrada.
-
Cuando el campo es un entero, las opciones estadísticas de superposición disponibles son Valor medio, Mayoría, Máximo, Mediana, Mínimo, Minoría, Rango y Variedad. Cuando el campo es de punto flotante, las únicas estadísticas permitidas son Valor medio, Máximo, Mínimo y Rango.
-
Para los tipos de estadísticas Mayoría, Máximo, Mediana, Mínimo, Minoría y Rango, el tipo de datos de salida del ráster será el mismo que el tipo de campo de entrada. Para el tipo de estadísticas Valor medio, el ráster de salida siempre será de punto flotante. Para Variedad, el ráster de salida siempre será un entero.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_polyline_features |
Las entidades de polilínea de entrada para las que se calcularán las Estadísticas de líneas. | Feature Layer |
field | El campo que se utilizará para calcular la estadística especificada. Puede ser cualquier campo numérico de las entidades de línea de entrada. Puede ser el campo Forma si las entidades de entrada contienen Z. | Field |
cell_size (Opcional) |
Tamaño de celda del dataset ráster de salida. Este es el valor del entorno si se lo establece específicamente. Si no está configurado en el entorno, es el valor más bajo del ancho o la altura de la extensión del dataset de entidades de entrada, en la referencia espacial de salida, dividido por 250. | Analysis Cell Size |
search_radius (Opcional) |
Radio de búsqueda dentro del cual se calculará la estadística deseada, en unidades de mapas. El radio predeterminado es cinco veces el tamaño de celda de salida. | Double |
statistics_type (Opcional) |
El tipo de estadística que se calculará. Las estadísticas se calculan sobre el valor del campo especificado para todas las líneas en la vecindad.
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de estadísticas de líneas de salida. | Raster |
Ejemplo de código
En este ejemplo se calcula la longitud media de los segmentos de línea dentro de un determinado radio de cada celda en el ráster de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
lineStatOut = LineStatistics("streams", "LENGTH", 50, 500, "MEAN")
lineStatOut.save("C:/sapyexamples/output/linestatout")
En este ejemplo se calcula la longitud media de los segmentos de línea dentro de un determinado radio de cada celda en el ráster de entrada.
# Name: LineStatistics_Ex_02.py
# Description:
# 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
inLines = "streams.shp"
field = "LENGTH"
cellSize = 50
searchRadius = 500
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
"MEAN")
# Save the output
lineStatOut.save("C:/sapyexamples/output/linestatisout")