Estadísticas de línea (Spatial Analyst)

Disponible con una licencia de 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ínea

Uso

  • El Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro o el tamaño de celda del entorno, pero se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se especifica nada, el tamaño de celda se calcula a partir de la anchura o la altura de la extensión dividido por 250, donde la extensión se encuentra en el Sistema de coordenadas de salida especificado en el entorno.

  • Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.

    Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente a la referencia espacial de salida, se proyecta en función del Método de proyección de tamaño de celda seleccionado.

  • Solo la parte de una línea dentro de la vecindad se considera para los estadísticas Mayoría, Valor Medio, Mediana, Minoría y Longitud. 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, entonces la estadística Variedad y Longitud se 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 y Largo. Para las demás estadísticas, el tipo de datos de salida es el mismo que el tipo de valor del elemento de entrada.

  • 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 los tipos de estadísticas Valor medio y Longitud, el ráster de salida siempre será de punto flotante. Para Variedad, el ráster de salida siempre será un entero.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de polilíneas de entrada

Las entidades de polilínea de entrada para las cuales se van a calcular las estadísticas en una vecindad alrededor de cada celda de salida.

Feature Layer
Campo

El campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de entrada.

Cuando el tipo de estadística se establece como el parámetro Longitud, el Campo se puede establecer en Ninguno.

Puede ser el campo Shape si las entidades de entrada contienen valores z.

Field
Tamaño de celda de salida
(Opcional)

El tamaño de celda del ráster de salida que se va a crear.

Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.

Analysis Cell Size
Radio de búsqueda
(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
Tipo de estadísticas
(Opcional)

Especifica el tipo de estadística que se calculará.

Las estadísticas se calculan sobre el valor del campo especificado para todas las líneas de la vecindad.

Cuando el campo especificado es un entero, las opciones estadísticas 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.

  • Valor medioCalcula 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.
  • MayoríaDetermina el valor que tiene la longitud más grande de la línea en la vecindad.
  • MáximoDetermina el valor más grande en la vecindad.
  • MedianaDetermina 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.
  • MínimoCalcula el valor menor en cada vecindad.
  • MinoríaDetermina el valor que tiene la longitud más pequeña de la línea en la vecindad.
  • RangoEl rango de valores (máximo-mínimo).
  • VariedadLa cantidad de valores únicos.
  • LongitudLa longitud de línea total en la vecindad. Si el valor del campo es otro que no sea 1, las longitudes se multiplican por el valor del elemento antes de sumarlos. Esta opción se puede usar cuando el parámetro Campo está establecido en Ninguno.
String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

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

Raster

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})
NombreExplicaciónTipo de datos
in_polyline_features

Las entidades de polilínea de entrada para las cuales se van a calcular las estadísticas en una vecindad alrededor de cada celda de salida.

Feature Layer
field

El campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de entrada.

Cuando el tipo de estadística se establece como Length, el parámetro field se puede establecer en Ninguno.

Puede ser el campo Shape si las entidades de entrada contienen valores z.

Field
cell_size
(Opcional)

El tamaño de celda del ráster de salida que se va a crear.

Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.

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)

Especifica el tipo de estadística que se calculará.

Las estadísticas se calculan sobre el valor del campo especificado para todas las líneas de la vecindad.

  • MEANCalcula 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.
  • MAJORITYDetermina 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.
  • MEDIANDetermina 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.
  • MINIMUMCalcula el valor menor en cada vecindad.
  • MINORITYDetermina el valor que tiene la longitud más pequeña de la línea en la vecindad.
  • RANGEEl rango de valores (máximo-mínimo).
  • VARIETYLa cantidad de valores únicos.
  • LENGTHLa longitud de línea total en la vecindad. Si el valor del campo es otro que no sea 1, las longitudes se multiplican por el valor del elemento antes de sumarlos. Esta opción se puede usar cuando el parámetro Campo está establecido en Ninguno.

Cuando el campo especificado es un entero, las opciones estadísticas 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.

String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

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

Raster

Muestra 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

# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
                              "MEAN")

# Save the output 
lineStatOut.save("C:/sapyexamples/output/linestatisout")

Temas relacionados