Interpoler une forme (3D Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Interpole des valeurs Z pour une classe d'entités selon l'altitude dérivée d'un raster, d'un réseau triangulé irrégulier (TIN) ou d'un jeu de données de MNT.

Pour en savoir plus sur l'outil Interpoler les formes

Illustration

Illustration de l'outil Interpoler les formes

Utilisation

Syntaxe

InterpolateShape_3d (in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution})
ParamètreExplicationType de données
in_surface

Jeu de données LAS, raster, TIN ou surface de MNT utilisés pour interpoler les valeurs z.

LAS Dataset Layer, Raster Layer; Terrain Layer; TIN Layer
in_feature_class

La classe d'entités en entrée.

Feature Layer
out_feature_class

Classe d'entités en sortie.

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 raster ou de la densification naturelle d'un TIN.

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 d'apparier les unités linéaires XY. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées.

Double
method
(Facultatif)

Méthode d'interpolation utilisée afin de déterminer des valeurs d'altitude pour les entités en sortie. Les options disponibles dépendent du type de surface utilisé. L'interpolation BILINEAR est disponible pour une surface raster, où un point de requête obtient son altitude à partir des valeurs trouvées dans les quatre cellules les plus proches. Les jeux de données de MNT et TIN fournissent les options suivantes :

  • LINEAR Méthode d'interpolation par défaut. Obtient une altitude à partir du plan défini par le triangle qui contient l'emplacement XY d'un point de requête.
  • NATURAL_NEIGHBORS Obtient une altitude en appliquant des pondérations basées sur la surface aux voisins naturels d'un point de requête.
  • CONFLATE_ZMIN Obtient l'altitude de la plus petite valeur Z recherchée parmi les voisins naturels d'un point de requête.
  • CONFLATE_ZMAX Obtient l'altitude de la plus grande valeur Z recherchée parmi les voisins naturels d'un point de requête.
  • CONFLATE_NEAREST Obtient l'altitude de la valeur la plus proche recherchée parmi les voisins naturels d'un point de requête.
  • CONFLATE_CLOSEST_TO_MEAN Obtient l'altitude 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 survient seulement le long des sommets d'une entité en entrée, en ignorant ainsi l'option de distance de référence.

  • DENSIFYEffectue une interpolation à l'aide de la distance de référence. Il s'agit de l'option par défaut.
  • VERTICES_ONLYEffectue une interpolation le long des 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 par cet outil. La valeur par défaut est 0 (ou résolution maximale).

Double

Exemple de code

1er exemple d'utilisation de l'outil InterpolateShape (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python :

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.InterpolateShape_3d("my_tin", "roads.shp", "roads_interp.shp")
2e exemple d'utilisation de l'outil 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
from arcpy import env
import exceptions, sys, traceback

# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)

try:
    arcpy.CheckOutExtension("3D")
    # Set default workspace
    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)
    arcpy.CheckInExtension('3D')
    
except arcpy.ExecuteError:
    print arcpy.GetMessages()
    
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis 3D Analyst
ArcGIS for Desktop Standard: Requis 3D Analyst
ArcGIS for Desktop Advanced: Requis 3D Analyst
6/5/2014