Interpoler les formes (3D Analyst)

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

Illustration de l’outil Interpoler les formes

Utilisation

  • 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 l’option 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.

Paramètres

ÉtiquetteExplicationType de données
Surface en entrée

Surface à utiliser 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. Cette option permet généralement de convertir les unités linéaires z afin d’apparier les 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 utilisé.

  • BilinéaireDétermine la valeur du point de requête à l’aide de l’interpolation bilinéaire. Il s’agit de la méthode par défaut pour toute surface raster en entrée.
  • Voisin le plus procheDétermine la valeur du point de requête à l’aide de l’interpolation par voisin le plus proche. Si cette méthode est utilisée, les valeurs de surface sont uniquement interpolées pour les sommets de l’entité en entrée. Cette option est disponible uniquement pour une surface raster.
  • LinéaireMéthode d’interpolation par défaut pour les jeux de données TIN, de MNT et LAS. L’élévation est obtenue à partir du plan défini par le triangle qui contient la localisation XY d’un point de requête.
  • Voisins naturelsObtient l’élévation en appliquant des pondérations basées sur la surface aux voisins naturels d’un point de requête.
  • Fusion de la valeur Z minimaleObtient l’élévation à partir de la plus petite valeur z détectée parmi les voisins naturels d’un point de requête.
  • Fusion de la valeur Z maximaleObtient l’élévation à partir de la plus grande valeur z détectée parmi les voisins naturels d’un point de requête.
  • Fusion de la valeur Z la plus procheObtient l’élévation à partir de la valeur la plus proche parmi les voisins naturels d’un point de requête.
  • Fusion de la valeur Z la plus proche de la moyenneObtient l’élévation à partir de la valeur z la plus proche de la moyenne de tous les voisins naturels d’un point de requête.
String
Interpoler les sommets uniquement
(Facultatif)

Indique si l’interpolation intervient uniquement sur les sommets d’une entité en entrée, en ignorant ainsi l’option de distance d’échantillonnage. En cas de surface raster en entrée et si 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.

  • Activé : effectue une interpolation sur les sommets.
  • Désactivé : effectue une interpolation à l’aide de la distance d’échantillonnage. Il s’agit de l’option par défaut.
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é : la valeur z de chaque sommet se trouvant en dehors de la surface raster est déduite de la tendance des valeurs z calculée pour les sommets inclus dans la surface raster.
  • Désactivé : les entités dont au moins un sommet se trouve en dehors de la surface raster sont ignorées dans la sortie. Il s’agit de l’option par défaut.
Boolean

arcpy.ddd.InterpolateShape(in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution}, {preserve_features})
NomExplicationType de données
in_surface

Surface à utiliser 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. Cette option permet généralement de convertir les unités linéaires z afin d’apparier les 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 utilisé.

  • BILINEARDétermine la valeur du point de requête à l’aide de l’interpolation bilinéaire. Il s’agit de la méthode par défaut pour toute surface raster en entrée.
  • NEARESTDétermine la valeur du point de requête à l’aide de l’interpolation par voisin le plus proche. Si cette méthode est utilisée, les valeurs de surface sont uniquement interpolées pour les sommets de l’entité en entrée. Cette option est disponible uniquement pour une surface raster.
  • LINEARMéthode d’interpolation par défaut pour les jeux de données TIN, de MNT et LAS. L’élévation est obtenue à partir du plan défini par le triangle qui contient la localisation XY d’un point de requête.
  • NATURAL_NEIGHBORSObtient l’élévation en appliquant des pondérations basées sur la surface aux voisins naturels d’un point de requête.
  • CONFLATE_ZMINObtient l’élévation à partir de la plus petite valeur z détectée parmi les voisins naturels d’un point de requête.
  • CONFLATE_ZMAXObtient l’élévation à partir de la plus grande valeur z détectée parmi les voisins naturels d’un point de requête.
  • CONFLATE_NEARESTObtient l’élévation à partir de la valeur la plus proche parmi les voisins naturels d’un point de requête.
  • CONFLATE_CLOSEST_TO_MEANObtient l’élévation à partir de la valeur z la plus proche de la moyenne de tous les voisins naturels d’un point de requête.
String
vertices_only
(Facultatif)

Indique si l’interpolation intervient uniquement sur les sommets d’une entité en entrée, en ignorant ainsi l’option de distance d’échantillonnage.

  • DENSIFYEffectue une interpolation à l’aide de la distance d’échantillonnage. Il s’agit de l’option par défaut.
  • VERTICES_ONLYEffectue une interpolation sur les sommets.
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.

  • PRESERVELa valeur z de chaque sommet se trouvant en dehors de la surface raster est déduite de la tendance des valeurs z calculée pour les sommets inclus dans la surface raster.
  • EXCLUDELes entités dont au moins un sommet se trouve en dehors de la surface raster sont ignorées dans la sortie. Il s’agit de l’option par défaut.
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.

arcpy.env.workspace = "C:/data"
arcpy.ddd.InterpolateShape("my_tin", "roads.shp", "roads_interp.shp")
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"
                # 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)

Informations de licence

  • Basic: Nécessite 3D Analyst
  • Standard: Nécessite 3D Analyst
  • Advanced: Nécessite 3D Analyst

Rubriques connexes