Étiquette | Explication | Type de données |
Surface en entrée | 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 qui seront traitées. | 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. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est 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.
| 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. Lorsque la surface en entrée est un raster et que la méthode d’interpolation par voisin le plus proche est sélectionnée, l’interpolation des valeurs z s’effectue uniquement aux sommets des entités.
| 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.
| Boolean |
Disponible avec une licence 3D Analyst.
Disponible avec une licence Spatial Analyst.
Synthèse
Crée des entités 3D en interpolant les valeurs z d’une surface.
En savoir plus sur le fonctionnement de l’outil Interpoler les formes
Illustration
Utilisation
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 représentation réelle de la surface, utilisez l’outil Interpoler des polygones vers multipatchs.
Toutes les lignes courbes ou segments de polygones seront densifiés en fonction de la valeur du paramètre 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 Interpoler les sommets uniquement, les entités dont les sommets se trouvent en dehors de la zone de données de la surface ne seront 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.
Paramètres
arcpy.ddd.InterpolateShape(in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution}, {preserve_features})
Nom | Explication | Type de données |
in_surface | 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 qui seront traitées. | 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. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est 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.
| 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.
| 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.
| Boolean |
Exemple de code
L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python.
arcpy.env.workspace = "C:/data"
arcpy.ddd.InterpolateShape("my_tin", "roads.shp", "roads_interp.shp")
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"
# Execute 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)
Environnements
Informations de licence
- Basic: Nécessite 3D Analyst
- Standard: Nécessite 3D Analyst
- Advanced: Nécessite 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?