ArcMap

Terrain in Punkte

Zusammenfassung

Mit diesem Werkzeug wird ein Terrain-Dataset in eine neue Point- oder Multipoint-Feature-Class konvertiert.

Abbildung

Beispiel für "Terrain in Punkte"

Verwendung

  • Punkte werden für die angegebene Auflösung der Pyramidenebene und den Interessenbereich extrahiert.
  • Wenn eine eingebettete Feature-Class angegeben wird, kommen die Ausgabepunkte nur aus den eingebetteten Features. Andernfalls werden die Ausgabepunkte aus allen Punkten abgeleitet, die zur Terrain-Oberfläche beitragen.

  • Wenn ein eingebettetes Feature LIDAR-Attribute enthält, z. B. RGB, Klassifizierung oder Rückgabewerte, werden die Attribute in die Ausgabe-Feature-Class geschrieben. Die Methode, mit der die Attribute geschrieben werden, hängt jedoch vom angegebenen Geometrietyp ab:

    • MULTIPOINT – Attribute werden im BLOB-Feld gespeichert.
    • POINT – Attribute werden in numerischen Feldern gespeichert.

  • Weitere Informationen zu eingebetteten Features finden Sie unter Eingebettete Feature-Classes.

Syntax

arcpy.ddd.TerrainToPoints(in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})
ParameterErklärungDatentyp
in_terrain

Das zu verarbeitende Terrain-Dataset.

Terrain Layer
out_feature_class

Die Feature-Class, die von diesem Werkzeug erstellt wird.

Feature Class
pyramid_level_resolution
(optional)

Die Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene, die von diesem Werkzeug verwendet wird. Der Standardwert ist 0, also volle Auflösung.

Double
source_embedded_feature_class
(optional)

Der Name der eingebetteten Punkte des Terrain-Datasets, die exportiert werden sollen. Wenn ein eingebettetes Feature angegeben wird, werden nur die Punkte aus dem Feature in die Ausgabe geschrieben. Andernfalls werden alle Punkte aus allen Datenquellen im Terrain exportiert.

String
out_geometry_type
(optional)

Die Geometrie der Ausgabe-Feature-Class.

  • MULTIPOINT —Die Ausgabe-Punkt-Features werden in eine Multipoint-Feature-Class geschrieben. Dies ist die Standardeinstellung.
  • POINT —Die Ausgabe-Punkt-Features werden in eine Point-Feature-Class geschrieben.
String

Codebeispiel

TerrainToPoints – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

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")
TerrainToPoints – Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

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

Umgebungen

Lizenzinformationen

  • Basic: Erfordert 3D Analyst
  • Standard: Erfordert 3D Analyst
  • Advanced: Erfordert 3D Analyst

Verwandte Themen