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.
Sintaxis
arcpy.3d.TerrainToPoints(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 |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = "C:/data"
arcpy.TerrainToPoints_3d("sample.gdb/featuredataset/terrain", "terrain_points.shp",
pyramid_level_resolution=6, out_geometry_type="POINT")
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''*****************************************************************
Name: TerrainToPoints Example
Description: This script demonstrates how to use the
TerrainToPoints tool.
*****************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.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)
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst