Tendencia (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con una licencia de 3D Analyst.

Resumen

Interpola una superficie de ráster a partir de puntos utilizando una técnica de tendencia.

Más información sobre cómo funciona Tendencia

Uso

• A medida que aumenta el orden de la función polinómica, la superficie que se ajusta se vuelve cada vez más compleja. Una función polinómica de mayor orden no siempre generará la superficie más precisa, esto depende de los datos.

• Para la opción Logística de Tipo de regresión, el campo valor z de las entidades de punto de entrada debe tener códigos de cero (0) y uno (1).

• 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.

• La salida del archivo RMS opcional contiene información sobre el error RMS (error cuadrático medio) de la interpolación. Esta información se puede utilizar para determinar el mejor valor para el orden de la función polinómica, cambiando el valor del orden hasta obtener el error RMS más bajo. Consulte Cómo funciona Tendencia para obtener información sobre el archivo RMS.

• Algunos datasets de entrada pueden tener algunos puntos con las mismas coordenadas x,y. Si los valores de los puntos de una ubicación común son los mismos, se consideran duplicados y no afectan a la salida. Si los valores son diferentes, se consideran puntos coincidentes.

  Las distintas herramientas de interpolación pueden manejar esta condición de datos de maneras distintas. Por ejemplo, en algunos casos el primer punto coincidente encontrado se utiliza para el cálculo; en otros casos, se utiliza el último punto encontrado. Esto puede causar que algunas ubicaciones del ráster de entrada tengan valores distintos a los que puede esperar. La solución es preparar los datos quitando estos puntos coincidentes. La herramienta Capturar eventos de la caja de herramientas de Estadística espacial es útil para identificar cualquier punto coincidente en los datos.

• Para los formatos de datos que admiten valores nulos, como las clases de entidad de geodatabase de archivos, se ignorará un valor nulo cuando se utilice como entrada.

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

Sintaxis

Trend(in_point_features, z_field, {cell_size}, {order}, {regression_type}, {out_rms_file})

Parámetro	Explicación	Tipo de datos
in_point_features	Entidades de puntos de entrada que contienen los valores z que se interpolarán en un ráster de superficie.	Feature Layer
z_field	Campo que contiene un valor de altura o magnitud para cada punto. Puede ser un campo numérico o el campo Forma si las entidades de punto de entrada contienen valores z. Si el tipo de regresión es logística, los valores en el campo sólo pueden ser 0 o 1.	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
order (Opcional)	El orden de la función polinómica. Debe ser un entero entre 1 y 12. Un valor de 1 ajustará un plano chato a los puntos y un valor superior ajustará una superficie más compleja. El valor predeterminado es 1.	Long
regression_type (Opcional)	El tipo de regresión que se va a realizar. LINEAR —La regresión polinómica se ejecuta para ajustar una superficie de mínimos cuadrados al conjunto de puntos de entrada. Esto se aplica para tipos de datos continuos. LOGISTIC —Se realiza el análisis de superficie de tendencia logística. Genera una superficie de probabilidad continua para tipos de datos binarios o dicótomos.	String
out_rms_file (Opcional)	El nombre del archivo para el archivo de texto de salida que contiene información sobre el error RMS y el chi-cuadrado de la interpolación. La extensión debe ser .txt.	File

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	Ráster de superficie interpolado de salida. Siempre es un ráster de punto flotante.	Raster

Muestra de código

Ejemplo 1 de Tendencia (ventana de Python)

En este ejemplo se introduce un shapefile de punto y se interpola la superficie de salida como ráster TIFF.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTrend = Trend("ozone_pts.shp", "ozone", 2000, 2, "LINEAR")
outTrend.save("C:/sapyexamples/output/trendout.tif")

Ejemplo 2 de Tendencia (script independiente)

En este ejemplo se introduce un shapefile de punto y se interpola la superficie de salida como ráster de cuadrícula.

# Name: Trend_Ex_02.py
# Description: Interpolate a series of point features 
#    onto a rectangular raster using a trend technique.
# 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
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 2000.0
PolynomialOrder = 2
regressionType = "LINEAR"


# Execute Trend
outTrend = Trend(inPointFeatures, zField, cellSize, 
                 PolynomialOrder, regressionType)

# Save the output 
outTrend.save("C:/sapyexamples/output/trendout02")

Entornos

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

Información de licenciamiento

• Basic: Requiere Spatial Analyst o 3D Analyst
• Standard: Requiere Spatial Analyst o 3D Analyst
• Advanced: Requiere Spatial Analyst o 3D Analyst