De terreno a puntos (3D Analyst)

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 de entrada.	Terrain Layer
out_feature_class	La clase de entidad de salida.	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)	El tipo de geometría de la clase de entidad de salida. MULTIPOINT —Las entidades de punto de salida se escribirán en una clase de entidad multipunto. Esta es la opción predeterminada. POINT —Las entidades de puntos de salida se escribirán en una clase de entidad puntos.	String

Ejemplo de código

Ejemplo 1 de TerrainToPoints (ventana de Python)

El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana 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)

El siguiente ejemplo 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

Espacio de trabajo actual, Espacio de trabajo temporal, Extensión, Sistema de coordenadas de salida, Transformaciones geográficas, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Palabra clave CONFIG de salida, Auto ejecución