Zusammenfassung
Mit diesem Werkzeug wird ein Terrain-Dataset in eine neue Point- oder Multipoint-Feature-Class konvertiert.
Bild
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
TerrainToPoints_3d (in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})| Parameter | Erläuterung | Datentyp |
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.
| 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)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert 3D Analyst
- ArcGIS for Desktop Standard: Erfordert 3D Analyst
- ArcGIS for Desktop Advanced: Erfordert 3D Analyst