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	The input terrain dataset.	Terrain Layer
out_feature_class	The output feature class.	Feature Class
pyramid_level_resolution (Opcional)	The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution.	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)

The following sample demonstrates the use of this tool in the Python window:

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)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''*****************************************************************
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

Información de licencia

ArcView: Requiere 3D Analyst

ArcEditor: Requiere 3D Analyst

ArcInfo: Requiere 3D Analyst