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.

Más información sobre cómo funciona Estadísticas de líneas

Uso

Sintaxis

LineStatistics (in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})
ParámetroExplicaciónTipo 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.

  • MEAN Calcula el valor de campo promedio en cada vecindad, ponderado por la longitud.El formato del cálculo es:
    • Valor medio= (suma de (longitud * field_value)) / (sum_of_length)
    Sólo se utiliza la parte de la longitud que cae dentro de la vecindad.
  • MAJORITY Determina el valor que tiene la longitud más grande de la línea en la vecindad.
  • MAXIMUMDetermina el valor más grande en la vecindad.
  • MEDIAN Determina el valor de la mediana, ponderado por la longitud.Conceptualmente, todos los segmentos de línea en la vecindad se ordenan por valor y se ubican de punta a punta en una línea recta. El valor del segmento en el punto medio de la línea recta es la mediana.
  • MINIMUM Calcula el valor menor en cada vecindad.
  • MINORITY Determina el valor que tiene la longitud más pequeña de la línea en la vecindad.
  • RANGE El rango de valores (máximo-mínimo).
  • VARIETY La cantidad de valores únicos.
String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de estadísticas de líneas de salida.

Raster

Ejemplo de código

Ejemplo 1 de LineStatistics (ventana de Python)

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")
Ejemplo 2 de LineStatistics (secuencia de comandos independiente)

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")

Entornos

Temas relacionados

Información de licencia

ArcView: Requiere Análisis espacial
ArcEditor: Requiere Análisis espacial
ArcInfo: Requiere Análisis espacial

7/11/2012