Zusammenfassung
Fügt einem Terrain-Dataset eine oder mehrere Feature-Classes hinzu.
Verwendung
Eingabe-Features müssen sich im selben Feature-Dataset befinden wie das Terrain-Dataset.
Für das Terrain-Dataset muss bereits mindestens eine Pyramidenebene definiert worden sein.
Abhängig vom Oberflächentyp, der mit Features verknüpft ist, die einem Terrain hinzugefügt wurden, muss das Terrain-Dataset möglicherweise mit Terrain berechnen neu erstellt werden. Das Dialogfeld Eigenschaften des Terrain-Datasets in ArcCatalog und das Dialogfeld Eigenschaften des Terrain-Layers in ArcMap enthalten beide einen Hinweis darauf, ob das Dataset erneut berechnet werden muss.
Aktivieren Sie die Option "Übersicht" für Bruchkanten- und Polygon-Oberflächen-Feature-Typen nur dann, wenn Features vereinfachte Geometrien enthalten und für den erwarteten Anzeigemaßstab visuell relevant sind. Bruchkanten können zum Beispiel nicht ausreichend sichtbar sein, um für eine Übersicht relevant zu sein, wohingegen ein Clip-Polygon nützlich sein kann. Wenn das Grenz-Feature detailliert ist, sollten Sie eine Generalisierung in Betracht ziehen und die gröbere Darstellung für die Übersicht verwenden. Die detaillierte Version sollte bei Anzeigemaßstäben verwendet werden, die besser für eine detailliertere Auflösung geeignet sind.
Für Terrain-Datasets, die in einer Enterprise-Geodatabase gespeichert sind, gilt Folgendes:
- Das Ziel-Terrain kann nicht als versioniert registriert werden.
- Die Eingabe-Feature-Class kann nicht als versioniert registriert werden.
Syntax
arcpy.ddd.AddFeatureClassToTerrain(in_terrain, in_features)
Parameter | Erklärung | Datentyp |
in_terrain | Das Terrain, dem Feature-Classes hinzugefügt werden. Für das Terrain-Dataset muss bereits mindestens eine Pyramidenebene erstellt worden sein. | Terrain Layer |
in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...] | Identifiziert Features, die dem Terrain hinzugefügt werden. Jedes Feature muss sich im gleichen Feature-Dataset wie das Terrain befinden und dessen Rolle muss anhand der folgenden Eigenschaften definiert werden:
| Value Table |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
derived_out_terrain | Das aktualisierte Terrain. | Terrain-Layer |
Codebeispiel
AddFeatureClassToTerrain – 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"
params = "terrain.gdb/terrainFDS/points2 SHAPE masspoints 2 0 10 true false "\
"points_embed <None> false"
arcpy.AddFeatureClassToTerrain_3d("test.gdb/featuredataset/terrain", params)
AddFeatureClassToTerrain – Beispiel 2 (eigenständiges Skript)
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.
"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
features extracted from a TIN. It is particularly useful in
situations where the source data used in the TIN is not available,
and the amount of data stored in the TIN proves to be too large
for the TIN. The terrain's scalability will allow improved
display performance and faster analysis. The script is designed
to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain
try:
arcpy.CheckOutExtension("3D")
# Create the file gdb that will store the feature dataset
arcpy.management.CreateFileGDB(gdbLocation, gdbName)
gdb = '{0}/{1}'.format(gdbLocation, gdbName)
# Obtain spatial reference from TIN
SR = arcpy.Describe(tin).spatialReference
# Create the feature dataset that will store the terrain
arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
fd = '{0}/{1}'.format(gdb, fdName)
# Export TIN elements to feature classes for terrain
arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
boundary = "{0}/boundary".format(fd)
# Execute TinDomain
arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
arcpy.AddMessage("Exporting TIN breaklines...")
breaklines = "{0}/breaklines".format(fd)
# Execute TinLine
arcpy.ddd.TinLine(tin, breaklines, "Code")
arcpy.AddMessage("Exporting TIN nodes...")
masspoints = "{0}/masspoints".format(fd)
# Execute TinNode
arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
arcpy.AddMessage("Creating terrain dataset...")
terrain = "terrain_from_tin"
# Execute CreateTerrain
arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
"WINDOWSIZE", "ZMEAN", "NONE", 1)
arcpy.AddMessage("Adding terrain pyramid levels...")
terrain = "{0}/{1}".format(fd, terrainName)
pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
# Execute AddTerrainPyramidLevel
arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
arcpy.AddMessage("Adding features to terrain...")
inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
"false; {1} Shape masspoints 1 0 50 true false points_embed "\
"<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
"<None> false".format(boundary, masspoints, breaklines)
# Execute AddFeatureClassToTerrain
arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
arcpy.AddMessage("Building terrain...")
# Execute BuildTerrain
arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
arcpy.GetMessages()
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)
finally:
arcpy.CheckInExtension("3D")
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst
Verwandte Themen
- Überblick über das Toolset "Datenmanagement"
- Grundlagen von Oberflächen
- Oberflächenformate
- Was ist ein Terrain-Dataset?
- Vorteile der Verwendung von Terrains
- Berechnen eines Terrain-Datasets mit Geoverarbeitungswerkzeugen
- Unterstützte Quelldatentypen in Terrain-Datasets
- Terrain-Dataset-Werkzeuge zum Importieren und Laden von Daten
- Oberflächen-Feature-Typ (SFType)
- Ankerpunkte
- Eingebettete Feature-Classes
- Pyramiden-Auflösungsgrenzen
- Gruppen