Spline (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 spline de curvatura mínima bidimensional.

La superficie de alisado resultante pasa exactamente a través de los puntos de entrada.

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

Uso

  • Mientras mayor sea el valor de Cantidad de puntos, más lisa será la superficie del ráster de salida.

  • El parámetro 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 Alinear ráster, se utiliza el tamaño de celda del ráster de alineación. Si no se especifica ningún valor, el tamaño de celda se calcula a partir del valor más pequeño de anchura o altura de la extensión dividido por 250 en el que la extensión se encuentra en el sistema de coordenadas de salida especificado en el entorno.

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

    Si el tamaño de celda se especifica utilizando un dataset ráster, el parámetro mostrará 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 utilizará 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.

  • La opción Regularizado del tipo de spline por lo general produce superficies más suaves que las creadas con la opción Tensión.

    • Con la opción Regularizado, los valores más altos utilizados para el parámetro de peso producen superficies más lisas. Los valores introducidos para este parámetro deben ser iguales o mayores que cero. Los valores típicos utilizados son 0, 0,001, 0,01, 0,1 y 0,5. El Peso es el cuadrado del parámetro, conocido en la documentación como tao (t).

    • Con la opción Tensión, los valores más altos introducidos para el parámetro de peso resultan en superficies más gruesas pero que se ajustan con precisión a los puntos de control. Los valores introducidos deben ser iguales o mayores que cero. Los valores comunes son 0, 1, 5 y 10. El Peso es el cuadrado del parámetro, conocido en la documentación como fi (Φ).

  • 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 entidades 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de puntos de entrada

Entidades de puntos de entrada que contienen los valores z que se interpolarán en un ráster de superficie.

Feature Layer
Campo de valores Z

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.

Field
Tamaño de celda de salida
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.

Analysis Cell Size
Tipo de Spline
(Opcional)

El tipo de spline que se va a utilizar.

  • RegularizadoProduce una superficie lisa y primeros derivados lisos.
  • TensiónAjusta la rigidez del interpolante de acuerdo con el carácter del fenómeno modelado.
String
Ponderada
(Opcional)

Parámetro que afecta el carácter de la interpolación de superficie.

Cuando se utiliza la opción Regularizado, esta define el peso de los terceros derivados de la superficie en la expresión de minimización de curvatura. Si se utiliza la opción Tensión, esta define el peso de la tensión.

El peso predeterminado es 0,1.

Double
Número de puntos
(Opcional)

La cantidad de puntos por región utilizados para la aproximación local.

El valor predeterminado es 12.

Long

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de superficie interpolado de salida.

Siempre es un ráster de punto flotante.

Raster

Spline(in_point_features, z_field, {cell_size}, {spline_type}, {weight}, {number_points})
NombreExplicaciónTipo 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.

Field
cell_size
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.

Analysis Cell Size
spline_type
(Opcional)

El tipo de spline que se va a utilizar.

  • REGULARIZEDProduce una superficie lisa y primeros derivados lisos.
  • TENSIONAjusta la rigidez del interpolante de acuerdo con el carácter del fenómeno modelado.
String
weight
(Opcional)

Parámetro que afecta el carácter de la interpolación de superficie.

Cuando se utiliza la opción REGULARIZED, esta define el peso de las derivadas terceras de la superficie en la expresión de minimización de curvatura. Si se utiliza la opción TENSION, esta define el peso de la tensión.

El peso predeterminado es 0,1.

Double
number_points
(Opcional)

La cantidad de puntos por región utilizados para la aproximación local.

El valor predeterminado es 12.

Long

Valor de retorno

NombreExplicaciónTipo 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 Spline (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"
outSpline = Spline("ozone_pts.shp", "ozone", 2000, "REGULARIZED", 0.1)
outSpline.save("C:/sapyexamples/output/splineout.tif")
Ejemplo 2 de Spline (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: Spline_Ex_02.py
# Description: Interpolate a series of point features onto a 
#    rectangular raster using a minimum curvature spline 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
inPntFeat = "ozone_pts.shp"
zField = "ozone"
cellSize = 2000.0
splineType = "REGULARIZED"
weight = 0.1

# Execute Spline
outSpline = Spline(inPntFeat, zField, cellSize, splineType, weight)

# Save the output 
outSpline.save("C:/sapyexamples/output/splineout02")

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

Temas relacionados