ArcMap

De terreno a puntos

Resumen

Convierte un dataset de terreno en una clase de entidad de punto o multipunto nueva.

Ilustración

Ejemplo de De terreno a puntos

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ámetroExplicaciónTipo 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.

  • 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

Muestra 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 Desktop Basic: Requiere 3D Analyst
  • ArcGIS Desktop Standard: Requiere 3D Analyst
  • ArcGIS Desktop Advanced: Requiere 3D Analyst

Temas relacionados