Vereinigen 3D (ArcGIS 3D Analyst)
Zusammenfassung
Führt geschlossene, überlappende Multipatch-Features aus einer Eingabe-Feature-Class zusammen.
Bild
Verwendung
-
Für diese Analyse ist eine geschlossene Multipatch-Geometrie erforderlich. Mit dem Werkzeug Ist geschlossen 3D kann ermittelt werden, ob eine Multipatch-Feature-Class geschlossene Features enthält, und mit dem Werkzeug Multipatch einschließen können Lücken in Multipatch-Features ausgeschlossen werden.
Multipatch-Features, die überlappende Volumina umfassen, werden durch Schneiden der Dreiecke und Ringe kombiniert, welche die Hüllen der Features bilden, sowie durch Entfernen der redundanten inneren Teile. Dieser Vorgang wird iterativ so lange durchgeführt, bis alle Multipatch-Features in der Feature-Class verarbeitet wurden.
Ein Gruppierungsfeld kann genutzt werden, um zu identifizieren, welche Features vereinigt werden sollen (wenn z. B. die Multipatches Gebäudeteile in einer Stadt und mehrere Features ein Gebäude darstellen). Dadurch kann die Performance deutlich erhöht werden, indem die Anzahl der Durchgänge reduziert wird, die das Werkzeug das Dataset durchlaufen muss. Statt ein Feature mit allen anderen Features zu vergleichen, wird es nur mit den Features in der Gruppe verglichen.
Wenn die Optimierung aktiviert ist, versucht das Werkzeug automatisch, die Features in Gruppen zu ordnen, indem der Rahmen für jedes Feature geprüft wird. Wenn ein Gruppierungsfeld angegeben wurde, kann durch Deaktivieren der Optimierung die Werkzeug-Performance erhöht werden. Auch ohne Gruppierungsfeld kann die Optimierung deaktiviert werden, wenn die gewünschte Ausgabe darin besteht, alle überlappenden Features in einem einzigen Multipatch zu vereinigen.
-
Legen Sie die Anzahl der zu aggregierenden Features mit Bedacht fest, da möglicherweise in der Ausgabe-Feature-Class sehr große und komplexe Features erstellt werden, was zu Darstellungsproblemen führen kann.
Wenn zwei oder mehr Multipatch-Features nur eine Kante oder einen Stützpunkt gemeinsam haben, generiert das Werkzeug eine Warnmeldung. Die Warnmeldung gibt an, dass das Ausgabe-Feature nicht einfach ist und nicht erstellt werden konnte. Die gleiche Meldung wird zurückgegeben, wenn eine Gruppe Multipatches enthält, die kein Volumen bzw. keinen Raum gemeinsam haben.
-
Es kann optional eine Tabelle erstellt werden, um die Attribute der Quell-Features zu identifizieren, die zum Erstellen jeder einzelnen vereinigten Ausgabe vereinigt wurden.
Hinweis:Eine Beziehung zwischen der Tabelle und der Ausgabe-Feature-Class kann festgelegt werden, um die Attribute abzufragen, die den Quell-Features zugeordnet sind. Weitere Informationen finden Sie unter Zuordnen von Attributen einer Tabelle mit einer anderen Tabelle.
Dieses Werkzeug ist ein 3D-Gruppenoperator, der analytische Funktionen für 3D-Features bereitstellt. Weitere Informationen zu Gruppenoperatoren und ihrer Verwendung finden Sie unter Arbeiten mit 3D-Gruppenoperatoren.
Syntax
| Parameter | Erläuterung | Datentyp |
in_feature_class |
Die geschlossenen Multipatch-Features für die Überschneidung und Zusammenfassung. | Feature Layer |
group_field (optional) |
Das Feld zum Identifizieren der Features, die zusammen gruppiert werden sollen. | Field |
out_feature_class |
Die Ausgabe-Multipatch-Feature-Class, die die aggregierten Features speichert. | Feature Class |
out_table (optional) |
Eine n:1-Tabelle, in der die Beziehung zwischen Eingabe-Features und ihren aggregierten Äquivalenten dargestellt wird. | Table |
disable_optimization (optional) |
Gibt an, ob eine Optimierung automatisch durchgeführt wird oder deaktiviert ist:
| Boolean |
output_all (optional) |
Legt fest, ob die Ausgabe-Feature-Class alle Features enthält oder nur diejenigen, die die vereinigten Features überlappen.
| Boolean |
Codebeispiel
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.Union3D_3d('multipatch.shp', 'union_output.shp', 'GROUP_FIELD',
'DISABLE', 'ENABLE', 'UnionTable.dbf')
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:
'''****************************************************************************
Name: Union3D Example
Description: This script demonstrates how to use the
Union3D tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
arcpy.CheckOutExtension('3D')
# Set environment settings
env.workspace = 'C:/data'
# Set Local Variables
inMP = "multipatch.shp"
# Ensure output multipatch has a unique name
outMP = arcpy.CreateUniqueName("union_output.shp")
outTbl = arcpy.CreateUniqueName("UnionTable.dbf")
GroupField = "Type"
optimize = "DISABLE"
solids = "ENABLE"
#Execute Union3D
arcpy.ddd.Union3D(inMP, outMP, GroupField, optimize, solids, outTbl)
arcpy.CheckInExtension('3D')
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)