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.
Syntax
arcpy.3d.TerrainToPoints(in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})
Parameter | Erklärung | 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
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
arcpy.env.workspace = "C:/data"
arcpy.TerrainToPoints_3d("sample.gdb/featuredataset/terrain", "terrain_points.shp",
pyramid_level_resolution=6, out_geometry_type="POINT")
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
# Set environment settings
arcpy.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)
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst