Esta herramienta crea entidades 3D utilizando valores de altura derivados de partes superpuestas de la superficie de entrada. Un polígono 3D solo almacenará valores z en su perímetro, ya que el interior de un polígono 3D se definirá de forma aleatoria cuando se represente. Por este motivo, por lo general, los polígonos 3D no son adecuados para representar información de altura no planar. Para generar una representación real de la superficie, utilice la herramienta Interpolar polígono a multiparche tool.
Cualquier segmento de línea o polígono curvados se densificará en función del valor del parámetro Distancia de muestra. Si no se define una distancia de muestra, este valor se obtendrá de la superficie de entrada. Para un ráster, el tamaño de muestra predeterminada será el tamaño de celda del ráster. Para un dataset de TIN, terreno o LAS, el muestreo predeterminado se basará en las aristas producidas por la superficie triangulada. Si la curva es más corta que el tamaño de muestreo, la curva se simplificará en una línea de dos puntos utilizando sus puntos de inicio y final.
Cuando utilice la interpolación de vecinos naturales, considere la posibilidad de especificar una distancia de muestra que sea igual o superior a la mitad del espaciado de punto promedio de los puntos de datos de la superficie.
Cuando utilice el parámetro Interpolar solo vértices, las entidades con vértices que caen fuera del área de datos de la superficie no formarán parte de la salida, a no ser que la superficie de entrada sea un ráster y se utilice el método de interpolación de vecino más cercano.
Si la clase de entidades de entrada contiene valores m, la clase de entidades de salida también contendrá valores m, y se conservarán los valores m originales de los vértices.
La superficie que se va a utilizar para interpolar valores z.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
Entidades de entrada
Las entidades de entrada que se procesarán.
Feature Layer
Clase de entidad de salida
Clase de entidad que se generará.
Feature Class
Distancia de muestreo
(Opcional)
El espaciado en el que se interpolarán los valores z. De manera predeterminada, es el tamaño de celda del dataset ráster o una densificación natural de una superficie de triángulos.
Double
Factor Z
(Opcional)
El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.
Double
Método
(Opcional)
Especifica el método de interpolación que se utilizará para determinar los valores de elevación para las entidades de salida. Las opciones disponibles dependen del tipo de superficie.
Bilinear—The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
Nearest Neighbor—The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
Linear—Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
Natural Neighbors—Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
Conflate Minimum Z—Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
Conflate Maximum Z—Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
Conflate Nearest Z—Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
Conflate Z Closest To Mean—Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
Interpolar sólo vértices
(Opcional)
Especifica si la interpolación ocurrirá solo a lo largo de los vértices de una entidad de entrada, con lo que se ignora la opción de distancia de muestra.
Activado—Interpolation will only occur along the vertices.
Desactivado—Interpolation will occur using the sampling distance. This is the default.
Boolean
Resolución de nivel de pirámide
(Opcional)
La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.
Double
Preservar entidades parcialmente fuera de la superficie
(Opcional)
Especifica si las entidades con uno o varios vértices que quedan fuera del área de datos del ráster se conservarán en la salida. Este parámetro solo está disponible cuando la superficie de entrada es un ráster y se usa el método de interpolación del vecino más cercano.
Activado—Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
Desactivado—Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
Interpolar los valores m para los vértices densificados
(Opcional)
Especifica si los valores m de los vértices de líneas y polígonos agregados mediante densificación se interpolarán a partir de los vértices originales de entrada.
Cuando se aplican, los valores m de los vértices densificados se interpolan a lo largo del segmento original entre dos vértices existentes que tienen valores m. Si alguno de los vértices originales carece de un valor m, los valores m de todos los vértices recién agregados a lo largo de ese segmento se establecen en NaN.
Activado—The m-values for densified vertices will be interpolated.
Desactivado—The m-values for densified vertices will not be interpolated. This is the default.
La superficie que se va a utilizar para interpolar valores z.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
in_feature_class
Las entidades de entrada que se procesarán.
Feature Layer
out_feature_class
Clase de entidad que se generará.
Feature Class
sample_distance
(Opcional)
El espaciado en el que se interpolarán los valores z. De manera predeterminada, es el tamaño de celda del dataset ráster o una densificación natural de una superficie de triángulos.
Double
z_factor
(Opcional)
El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.
Double
method
(Opcional)
Especifica el método de interpolación que se utilizará para determinar los valores de elevación para las entidades de salida. Las opciones disponibles dependen del tipo de superficie.
BILINEAR—The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
NEAREST—The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
LINEAR—Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
NATURAL_NEIGHBORS—Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
CONFLATE_ZMIN—Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
CONFLATE_ZMAX—Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
CONFLATE_NEAREST—Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
CONFLATE_CLOSEST_TO_MEAN—Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
vertices_only
(Opcional)
Especifica si la interpolación ocurrirá solo a lo largo de los vértices de una entidad de entrada, con lo que se ignora la opción de distancia de muestra.
VERTICES_ONLY—Interpolation will only occur along the vertices.
DENSIFY—Interpolation will occur using the sampling distance. This is the default.
Boolean
pyramid_level_resolution
(Opcional)
La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.
Double
preserve_features
(Opcional)
Especifica si las entidades con uno o varios vértices que quedan fuera del área de datos del ráster se conservarán en la salida. Este parámetro solo está disponible cuando la superficie de entrada es un ráster y se usa el método de interpolación del vecino más cercano.
PRESERVE—Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
EXCLUDE—Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
interpolate_m_value
(Opcional)
Especifica si los valores m de los vértices de líneas y polígonos agregados mediante densificación se interpolarán a partir de los vértices originales de entrada.
Cuando se aplican, los valores m de los vértices densificados se interpolan a lo largo del segmento original entre dos vértices existentes que tienen valores m. Si alguno de los vértices originales carece de un valor m, los valores m de todos los vértices recién agregados a lo largo de ese segmento se establecen en NaN.
INTERPOLATE_M_VALUE—The m-values for densified vertices will be interpolated.
NO_INTERPOLATE_M_VALUE—The m-values for densified vertices will not be interpolated. This is the default.
Boolean
Muestra de código
Ejemplo 1 de InterpolateShape (ventana de Python)
El siguiente ejemplo muestra cómo usar esta herramienta en la ventana de Python:
Ejemplo 2 de InterpolateShape (script independiente)
El siguiente ejemplo muestra cómo usar esta herramienta en un script independiente de Python:
'''*********************************************************************
Name: InterpolateShape Example
Description: This script demonstrates how to use InterpolateShape
on all 2D features in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)
try:
# Set default workspace
arcpy.env.workspace = inWorkspace
# Create list of feature classes in target workspace
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Find 2D features
if not desc.hasZ:
# Set Local Variables
outFC = "{0}_3D.shp".format(desc.basename)
method = "BILINEAR"
# Run InterpolateShape
arcpy.ddd.InterpolateShape(surface, fc, outFC,
10, 1, method, True)
else:
print("{0} is not a 2D feature.".format(fc))
else:
print("No feature classes were found in {0}.".format(env.workspace))
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err)
