Résumé
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 géométries de type point, multi-points, ligne et 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
arcpy.ddd.FeatureTo3DByAttribute(in_features, out_feature_class, height_field, {to_height_field})
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 qui va être produite par cet outil. | 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
Exemple 1 d'utilisation de l'outil FeatureTo3DByAttribute (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.FeatureTo3DByAttribute_3d('Points2D.shp', 'Points3D.shp', 'Elevation')
Exemple 2 d'utilisation de l'outil FeatureTo3DByAttribute (script autonome)
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)
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst