Résumé
Convertit un jeu de données de MNT en une nouvelle classe d'entités multi-points ou ponctuelles.
Illustration
Utilisation
- Les points sont extraits pour la résolution des niveaux de pyramide et la zone d'intérêt spécifiées.
- Si une classe d'entités intégrée est spécifiée, les points en sortie proviennent uniquement des entités intégrées. Sinon, les points en sortie sont dérivés de tous les points contribuant à la surface de MNT.
Si une entité intégrée contient des attributs LIDAR, comme RVB, la classification ou des valeurs renvoyées, les attributs sont écrits dans la classe d'entités en sortie. Toutefois, la façon dont les attributs sont écrits dépend du type de géométrie spécifié :
- MULTIPOINT - Les attributs sont stockés dans le champ BLOB.
- POINT - Les attributs sont stockés dans des champs numériques.
Pour en savoir plus sur les entités intégrées, reportez-vous à la rubrique Classes d'entités intégrées.
Syntaxe
TerrainToPoints(in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})
Paramètre | Explication | Type de données |
in_terrain | Jeu de données de MNT à traiter. | Terrain Layer |
out_feature_class | Classe d'entités qui va être produite par cet outil. | Feature Class |
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 |
source_embedded_feature_class (Facultatif) | Nom des points intégrés du jeu de données de MNT à exporter. Si une entité intégrée est spécifiée, seuls les points de l'entité sont écrits dans la sortie. Sinon, les points de toutes les sources de données du MNT sont exportés. | String |
out_geometry_type (Facultatif) | Géométrie de la classe d'entités en sortie.
| String |
Exemple de code
1er exemple d'utilisation de l'outil TerrainToPoints (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.TerrainToPoints_3d("sample.gdb/featuredataset/terrain", "terrain_points.shp", "6", "<NONE>", "POINT")
2e exemple d'utilisation de l'outil TerrainToPoints (script autonome)
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''*****************************************************************
Name: TerrainToPoints Example
Description: This script demonstrates how to use the
TerrainToPoints tool.
*****************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
terrain = "sample.gdb/featuredataset/terrain"
outPts = arcpy.CreateUniqueName("terrain_pts", "sample.gdb")
outGeo = "POINT"
# Execute TerrainToPoints
arcpy.ddd.TerrainToPoints(terrain, outPts, 6, "<NONE>", outGeo)
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