Terrain in Punkte (3D Analyst)
Zusammenfassung
Mit diesem Werkzeug wird ein Terrain-Dataset in eine neue Point- oder Multipoint-Feature-Class konvertiert.
Abbildung
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
Parameter | Erläuterung | Datentyp |
in_terrain |
The input terrain dataset. | Terrain Layer |
out_feature_class |
The output feature class. | Feature Class |
pyramid_level_resolution (optional) |
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 (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) |
Der Geometrietyp der Ausgabe-Feature-Class.
| String |
Codebeispiel
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")
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)