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

• Hay varios tipos de estadísticas entre los que elegir. La selección de las estadísticas disponibles depende del tipo de campo especificado.

• Para los campos enteros, las opciones válidas para Tipo de estadística son: mayoría, máximo, valor medio, mediana, mínimo, minoría, rango, variedad y longitud. Para los campos flotantes, los tipos de estadística válidos son: máximo, valor medio, mínimo, rango y longitud. Los tipos mayoría, minoría y variedad no están disponibles.

• Si el tipo de campo es entero, el ráster de salida será entero para los siguientes tipos de estadística: mayoría, máximo, mediana, mínimo, minoría, rango y variedad. La salida será flotante para las estadísticas de tipo valor medio y longitud.

  Si el tipo de campo es flotante, el ráster de salida será flotante para todos los tipos de estadística disponibles.

• Solo la parte de una línea dentro de la vecindad se considera para los tipos de estadística mayoría, valor medio, mediana, minoría y longitud. Para las estadísticas de tipo máximo, mínimo, rango y variedad, se puede utilizar una parte o toda la línea.

• Los tipos de estadística mayoría, valor medio, mediana y minoría se ponderan en función de 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.

• Si no hay líneas en la vecindad de una celda ráster, las estadísticas de tipo variedad y longitud asignan un valor de cero. Para las otras estadísticas, se asigna NoData.

• El parámetro Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse a partir de 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 de la referencia espacial de salida, se proyectará en función del valor de Método de proyección de tamaño de celda especificado.

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de polilíneas de entrada	Líneas de entrada a utilizar en la operación de vecindad. Para cada celda de salida, se calculará una estadística para todas las porciones de las entidades de polilínea de entrada que caen en una vecindad circular alrededor de esa celda. El tamaño de la vecindad circular viene definido por el radio de búsqueda.	Feature Layer
Campo	Campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de línea de entrada. Si Tipo de estadística se establece en Longitud, el parámetro Campo se puede establecer en NONE. 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 que se utilizará para calcular la estadística, en unidades de mapa. 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. El tipo de estadísticas por defecto es Valor medio. Las opciones disponibles para el tipo de estadística vienen determinadas por el tipo numérico del campo especificado. Si el campo es entero, las opciones para el tipo de estadística disponibles serán mayoría, máximo, valor medio, mediana, mínimo, minoría, rango, variedad y longitud. Si el campo es de coma flotante, solo estarán disponibles las estadísticas de valor medio, máximo, mínimo, rango y longitud. Valor medio—Se calculará el valor de campo promedio en cada vecindad, ponderado por la longitud.El cálculo tiene este formato: Valor medio = (sum of (longitud * field_value)) / (sum_of_length).Solo se utiliza la parte de la línea que cae dentro de la vecindad. Mayoría—Se identificará el valor que tenga la mayor longitud de línea en la vecindad. Máximo—Se identificará el valor más grande de la vecindad. Mediana—Se calculará el valor de mediana, ponderado por la longitud.Conceptualmente, todos los segmentos de línea en la vecindad se ordenan por valor y se ubican de extremo a extremo en una línea recta. El valor del segmento en el punto medio de la línea recta es la mediana. Mínimo—Se identificará el valor más pequeño de la vecindad. Minoría—Se identificará el valor que tenga la longitud de línea menor en la vecindad. Rango—Se calculará el rango de valores (máximo-mínimo). Variedad—Se calculará el número de valores únicos. Longitud—Se calculará la longitud de línea total en la vecindad. Si el valor del campo no es 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

Etiqueta	Explicación	Tipo de datos
Ráster de salida	Ráster de estadística de línea de salida.	Raster

Python

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})

Nombre	Explicación	Tipo de datos
in_polyline_features	Líneas de entrada a utilizar en la operación de vecindad. Para cada celda de salida, se calculará una estadística para todas las porciones de las entidades de polilínea de entrada que caen en una vecindad circular alrededor de esa celda. El tamaño de la vecindad circular viene definido por el radio de búsqueda.	Feature Layer
field	Campo para el que se calculará la estadística especificada. Puede ser cualquier campo numérico de las entidades de línea de entrada. Si statistics_type se establece en Length, el parámetro field se puede establecer en NONE. 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 que se utilizará para calcular la estadística, en unidades de mapa. 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. MEAN—Se calculará el valor de campo promedio en cada vecindad, ponderado por la longitud.El cálculo tiene este formato: Valor medio = (sum of (longitud * field_value)) / (sum_of_length).Solo se utiliza la parte de la línea que cae dentro de la vecindad. MAJORITY—Se identificará el valor que tenga la mayor longitud de línea en la vecindad. MAXIMUM—Se identificará el valor más grande de la vecindad. MEDIAN—Se calculará el valor de mediana, ponderado por la longitud.Conceptualmente, todos los segmentos de línea en la vecindad se ordenan por valor y se ubican de extremo a extremo en una línea recta. El valor del segmento en el punto medio de la línea recta es la mediana. MINIMUM—Se identificará el valor más pequeño de la vecindad. MINORITY—Se identificará el valor que tenga la longitud de línea menor en la vecindad. RANGE—Se calculará el rango de valores (máximo-mínimo). VARIETY—Se calculará el número de valores únicos. LENGTH—Se calculará la longitud de línea total en la vecindad. Si el valor del campo no es 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. El tipo de estadísticas por defecto es MEAN. Las opciones disponibles para el tipo de estadística vienen determinadas por el tipo numérico del campo especificado. Si el campo es entero, las opciones para el tipo de estadística disponibles serán mayoría, máximo, valor medio, mediana, mínimo, minoría, rango, variedad y longitud. Si el campo es de coma flotante, solo estarán disponibles las estadísticas de valor medio, máximo, mínimo, rango y longitud.	String

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	Ráster de estadística 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")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

• Basic: Requiere Spatial Analyst
• Standard: Requiere Spatial Analyst
• Advanced: Requiere Spatial Analyst