| Beschriftung | Erläuterung | Datentyp |
Eingabe-Multipatch-Features | Die Multipatch-Features, die vereinigt werden. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Multipatch-Feature-Class, die die aggregierten Features speichert. | Feature Class |
Gruppierfeld (optional) | Das Feld, das zur Identifizierung der zu gruppierenden Merkmale verwendet wird. | Field |
Optimierung deaktivieren (optional) | Legt fest, ob die Eingabedaten optimiert werden. Bei der Optimierung werden die Eingabedaten vorverarbeitet. Dazu werden sie gruppiert, um die Performance zu verbessern und eindeutige Ausgaben für jeden Satz überlappender Features zu erstellen.
| Boolean |
Ausgabe aller Raster-Features (optional) | Legt fest, ob die Ausgabe-Feature-Class alle Features enthält oder nur die überlappenden Features, die vereinigt wurden.
| Boolean |
Ausgabetabelle (optional) | Eine Viele-zu-Eins-Tabelle, die die Eingabe-Features identifiziert, die zur jeweiligen Ausgabe beitragen. | Table |
Zusammenfassung
Führt geschlossene, überlappende Multipatch-Features aus einer Eingabe-Feature-Class zusammen.
Abbildung
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.
Dieses Werkzeug kombiniert sich überschneidende Multipatch-Features, die überlappende Volumen umfassen. Dabei werden die äußersten Teile der Eingabe-Features beibehalten und die Geometrie entfernt, die im Innenbereich des kombinierten Features liegt. Es kann eine separate Tabelle erstellt werden, um die Quell-Features zu identifizieren, die zum Erstellen der jeder einzelnen kombinierten Ausgabe zusammengeführt wurden.
Mit einem Gruppierungsfeld können die Features identifiziert werden, die vereinigt werden sollen (wenn z. B. mehrere Features Teile desselben Gebäudes 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. Falls kein Gruppierungsfeld vorhanden ist, kann die Optimierung auch deaktiviert werden, wenn die gewünschte Ausgabe darin besteht, wenn in der Ausgabe alle überlappenden Features zu einem einzigen Multipatch vereinigt werden sollen. Gehen Sie bei der Entscheidung, wie viele Features aggregiert werden sollen, mit Bedacht vor, da möglicherweise sehr große und komplexe Features in der Ausgabe-Feature-Class erstellt werden und dadurch ggf. die Darstellungs-Performance beeinträchtigt wird.
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. Diese Meldung gibt an, dass aufgrund eines fehlenden gemeinsamen Raumvolumens die Features nicht zusammengeführt wurden.
Texturen und Farben in den Eingabe-Multipatch-Features werden in der Ausgabe nicht beibehalten.
Parameter
arcpy.ddd.Union3D(in_feature_class, out_feature_class, {group_field}, {disable_optimization}, {output_all}, {out_table})| Name | Erläuterung | Datentyp |
in_feature_class | Die Multipatch-Features, die vereinigt werden. | Feature Layer |
out_feature_class | Die Ausgabe-Multipatch-Feature-Class, die die aggregierten Features speichert. | Feature Class |
group_field (optional) | Das Feld, das zur Identifizierung der zu gruppierenden Merkmale verwendet wird. | Field |
disable_optimization (optional) |
Legt fest, ob die Eingabedaten optimiert werden. Bei der Optimierung werden die Eingabedaten vorverarbeitet. Dazu werden sie gruppiert, um die Performance zu verbessern und eindeutige Ausgaben für jeden Satz überlappender Features zu erstellen.
| Boolean |
output_all (optional) |
Legt fest, ob die Ausgabe-Feature-Class alle Features enthält oder nur die überlappenden Features, die vereinigt wurden.
| Boolean |
out_table (optional) | Eine Viele-zu-Eins-Tabelle, die die Eingabe-Features identifiziert, die zur jeweiligen Ausgabe beitragen. | Table |
Codebeispiel
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
import arcpy
from arcpy import env
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
# Set environment settings
arcpy.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)