Cet outil crée des entités 3D en utilisant les valeurs de hauteur dérivées des portions superposées de la surface en entrée. Un polygone 3D ne stockera que les valeurs z sur son périmètre, puisque l’intérieur d’un polygone 3D sera défini de manière aléatoire lors de son rendu. C’est pourquoi, les polygones 3D ne conviennent généralement pas pour représenter les informations de hauteur non planaires. Pour générer une véritable représentation de la surface, utilisez l’outil Interpolate Polygon To Multipatch (Interpoler des polygones vers multipatchs).
Toutes les lignes courbes ou tous les segments de polygone seront densifiés en fonction de la valeur du paramètre Sampling Distance (Distance d’échantillonnage). Si une distance d’échantillonnage n’est pas définie, cette valeur sera dérivée de la surface en entrée. Pour un raster, la taille d’échantillonnage par défaut sera la taille de cellule du raster. Pour un jeu de données TIN, MNT ou LAS, l’échantillonnage par défaut sera fonction des tronçons produits par la surface triangulée. Si la courbe est plus courte que la taille d’échantillonnage, la courbe sera simplifiée en une ligne à deux points en utilisant ses points de début et de fin.
Lorsque vous utilisez l’interpolation par voisins naturels, spécifiez une distance d’échantillonnage égale ou supérieure à la moitié de l’espacement moyen des points de données sur la surface.
Lorsque vous utilisez le paramètre Interpolate Vertices Only (Interpoler les sommets uniquement), les entités dont les sommets se trouvent en dehors de la zone de données de la surface ne sont pas incluses dans la sortie, sauf si la surface en entrée est une surface raster et si la méthode d’interpolation par voisin le plus proche est utilisée.
Si la classe d’entités en entrée contient des valeurs m, la classe d’entités en sortie contiendra également des valeurs m, et les valeurs m des sommets originaux seront conservées.
La surface qui sera utilisée pour interpoler les valeurs z.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
Entités en entrée
Entités en entrée à traiter.
Feature Layer
Classe d’entités en sortie
Classe d’entités qui va être produite.
Feature Class
Distance d’échantillonnage
(Facultatif)
Espacement selon lequel les valeurs z sont interpolées. Par défaut, il s’agit de la taille de cellule d’un jeu de données raster ou de la densification naturelle d’une surface triangulée.
Double
Facteur Z
(Facultatif)
Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.
Double
Méthode
(Facultatif)
Indique la méthode d’interpolation utilisée pour déterminer les valeurs d’élévation des entités en sortie. Les options disponibles dépendent du type de surface.
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
Interpoler les sommets uniquement
(Facultatif)
Indique si l’interpolation se produira uniquement le long des sommets d’une entité en entrée, en ignorant l’option de distance d’échantillonnage.
Activé—Interpolation will only occur along the vertices.
Décoché—Interpolation will occur using the sampling distance. This is the default.
Boolean
Résolution des niveaux de pyramide
(Facultatif)
Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).
Double
Conserver les entités qui se trouvent partiellement en dehors de la surface
(Facultatif)
Indique si les entités dont un ou plusieurs sommets se trouvent en dehors de la zone de données du raster sont conservées dans la sortie. Ce paramètre est disponible uniquement en cas de surface raster en entrée et si la méthode d’interpolation par voisin le plus proche est utilisée.
Activé—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.
Décoché—Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
Interpoler les valeurs m pour les sommets densifiés
(Facultatif)
Indique si les valeurs m des sommets de ligne et de polygone ajoutés via la densification sont interpolées à partir des sommets en entrée originaux.
Lorsque cette option est appliquée, les valeurs m des sommets densifiés sont interpolées le long du segment original entre deux sommets existants qui possèdent des valeurs m. Si l’un des sommets originaux ne possède pas de valeur m, les valeurs m de tous les nouveaux sommets ajoutés le long de ce segment sont définies sur NaN.
Activé—The m-values for densified vertices will be interpolated.
Décoché—The m-values for densified vertices will not be interpolated. This is the default.
La surface qui sera utilisée pour interpoler les valeurs z.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
in_feature_class
Entités en entrée à traiter.
Feature Layer
out_feature_class
Classe d’entités qui va être produite.
Feature Class
sample_distance
(Facultatif)
Espacement selon lequel les valeurs z sont interpolées. Par défaut, il s’agit de la taille de cellule d’un jeu de données raster ou de la densification naturelle d’une surface triangulée.
Double
z_factor
(Facultatif)
Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.
Double
method
(Facultatif)
Indique la méthode d’interpolation utilisée pour déterminer les valeurs d’élévation des entités en sortie. Les options disponibles dépendent du type de surface.
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
(Facultatif)
Indique si l’interpolation se produira uniquement le long des sommets d’une entité en entrée, en ignorant l’option de distance d’échantillonnage.
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
(Facultatif)
Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).
Double
preserve_features
(Facultatif)
Indique si les entités dont un ou plusieurs sommets se trouvent en dehors de la zone de données du raster sont conservées dans la sortie. Ce paramètre est disponible uniquement en cas de surface raster en entrée et si la méthode d’interpolation par voisin le plus proche est utilisée.
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
(Facultatif)
Indique si les valeurs m des sommets de ligne et de polygone ajoutés via la densification sont interpolées à partir des sommets en entrée originaux.
Lorsque cette option est appliquée, les valeurs m des sommets densifiés sont interpolées le long du segment original entre deux sommets existants qui possèdent des valeurs m. Si l’un des sommets originaux ne possède pas de valeur m, les valeurs m de tous les nouveaux sommets ajoutés le long de ce segment sont définies sur 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
Exemple de code
Exemple 1 d’utilisation de la fonction InterpolateShape (fenêtre Python)
L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :
Exemple 2 d’utilisation de la fonction InterpolateShape (script autonome)
L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :
'''*********************************************************************
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)
