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.
Uso
La opción REGULARIZED del tipo de spline por lo general produce superficies más suaves que las creadas con la opción TENSION.
Con la opción REGULARIZED, 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 opcion TENSION, 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 (Φ).
Mientras mayor sea el valor de Cantidad de puntos, más lisa será la superficie del ráster de salida.
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.
Sintaxis
Spline_3d (in_point_features, z_field, out_raster, {cell_size}, {spline_type}, {weight}, {number_points})
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. | Field |
out_raster | Ráster de superficie interpolado de salida. Siempre es un ráster de punto flotante. | Raster Dataset |
cell_size (Opcional) | El tamaño de celda con el que se creará el ráster de salida. Este será el valor del entorno si se establece explícitamente; de lo contrario, es el valor más bajo del ancho o de la altura de la extensión de las entidades de punto de entrada, en la referencia espacial de entrada, dividido por 250. | Analysis Cell Size |
spline_type (Opcional) | El tipo de spline que se va a utilizar.
| 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 |
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
env.workspace = "C:/data"
arcpy.Spline_3d("ozone_pts.shp", "ozone", "C:/output/splineout.tif",
2000, "REGULARIZED", 0.1)
Ejemplo 2 de Spline (secuencia de comandos 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_3d_Ex_02.py
# Description: Interpolate a series of points onto a rectangular
# raster using a minimum curvature spline technique.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
outRaster = "C:/output/splineout"
cellSize = 2000.0
splineType = "REGULARIZED"
weight = 0.1
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Spline
arcpy.Spline_3d(inPointFeatures, zField, outRaster, cellSize,
splineType, weight)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere 3D Analyst o Spatial Analyst
- ArcGIS Desktop Standard: Requiere 3D Analyst o Spatial Analyst
- ArcGIS Desktop Advanced: Requiere 3D Analyst o Spatial Analyst