Resumen
Convierte un dataset de terreno en una clase de entidad de punto o multipunto nueva.
Ilustración
Uso
- Los puntos se extraen para la resolución de nivel de la pirámide especificada y el área de interés.
- Si especifica una clase de entidad integrada, los puntos de salida solo provendrán de las entidades integradas. De lo contrario, los puntos de salida se derivarán de todos los puntos que contribuyen con la superficie del terreno.
Si una entidad integrada consta de atributos lidar, como RGB, clasificación o valores de devolución, los atributos se escribirán en la clase de entidad de salida. Sin embargo, la manera en la que se escriben los atributos dependerá del tipo de geometría que se especifica:
- MULTIPOINT: el resultado se almacenará en un campo numérico.
- POINT: el resultado se almacenará en un campo numérico.
Para obtener más información sobre las entidades integradas, lea Clases de entidad integradas.
Sintaxis
TerrainToPoints_3d (in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})| Parámetro | Explicación | Tipo de datos |
in_terrain | El dataset de terreno que se va a procesar. | Terrain Layer |
out_feature_class | La clase de entidad que generará esta herramienta. | Feature Class |
pyramid_level_resolution (Opcional) | La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que utilizará esta herramienta. El valor predeterminado es 0, o resolución completa. | Double |
source_embedded_feature_class (Opcional) | El nombre de los puntos integrados de un dataset de terreno que se exportarán. Si se especifica una entidad integrada, solo los puntos de la entidad se escribirán en la salida. De lo contrario, todos los puntos de todas las fuentes de datos en el terreno se exportarán. | String |
out_geometry_type (Opcional) | La geometría de la clase de entidad de salida.
| String |
Ejemplo de código
Ejemplo 1 de TerrainToPoints (ventana de Python)
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de 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")
Ejemplo 2 de TerrainToPoints (secuencia de comandos independiente)
En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.
'''*****************************************************************
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)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere 3D Analyst
- ArcGIS for Desktop Standard: Requiere 3D Analyst
- ArcGIS for Desktop Advanced: Requiere 3D Analyst