Entité en 3D par attribut (3D Analyst)
Récapitulatif
Crée des entités 3D à l'aide de valeurs de hauteur dérivées de l'attribut des entités en entrée.
Utilisation
-
Prend en charge des points, multi-points, lignes et géométries de polygone.
-
L'altitude de chaque entité est dérivée de la valeur obtenue dans le champ de hauteur spécifié.
-
Les entités linéaires peuvent éventuellement fournir un second champ de hauteur. Lors de l'utilisation de deux champs de hauteur, chaque entité linéaire commence à la valeur Z obtenue dans le premier champ de hauteur et se termine à la valeur Z issue du second champ de hauteur. Les hauteurs des sommets intermédiaires sont interpolées en fonction de la pente de la ligne entre les deux points de fin.
Syntaxe
Paramètre | Explication | Type de données |
in_features |
Entités utilisées pour créer les entités 3D. | Feature Layer |
out_feature_class |
Classe d'entités en sortie. | Feature Class |
height_field |
Champ dont les valeurs définissent la hauteur des entités 3D obtenues. | Field |
to_height_field (Facultatif) |
Second champ de hauteur facultatif utilisé pour les lignes. Si vous utilisez deux champs de hauteur, chaque ligne commence à la première hauteur et finit à la deuxième (inclinée). | Field |
Exemple de code
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.FeatureTo3DByAttribute_3d('Points2D.shp', 'Points3D.shp', 'Elevation')
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome :
'''****************************************************************************
Name: FeatureTo3DByAttribute Example
Description: This script demonstrates how to use the
FeatureTo3DByAttribute tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension('3D')
# Set environment settings
env.workspace = 'C:/data'
# Set Local Variables
InFC = 'Points_2D.shp'
Height_Field = 'POPULATION'
# Ensure output has unique name
OutFC = arcpy.CreateUniqueName('Points_3D.shp')
# Execute ConstructSightLines
arcpy.FeatureTo3DByAttribute_3d(InFC, OutFC, Height_Field)
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)