Vereinigen 3D (3D Analyst)

Zusammenfassung

Führt geschlossene, überlappende Multipatch-Features aus einer Eingabe-Feature-Class zusammen.

Abbildung

Abbildung zum Werkzeug "Vereinigen 3D"

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

BeschriftungErläuterungDatentyp
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.

  • Deaktiviert: Die Eingabedaten werden optimiert. Das Gruppierungsfeld wird ignoriert. Dies ist die Standardeinstellung.
  • Aktiviert: Die Eingabedaten werden nicht optimiert. Features werden in einem einzigen Ausgabe-Feature gespeichert oder gemäß dem Gruppierungsfeld vereinigt, falls eines bereitgestellt wird.
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.

  • Aktiviert: Alle Eingabe-Features werden in die Ausgabe geschrieben. Dies ist die Standardeinstellung.
  • Deaktiviert: Nur vereinigte Features werden in die Ausgabe geschrieben. Nicht überlappende Features werden ignoriert.
Boolean
Ausgabetabelle
(optional)

Eine Viele-zu-Eins-Tabelle, die die Eingabe-Features identifiziert, die zur jeweiligen Ausgabe beitragen.

Table

arcpy.ddd.Union3D(in_feature_class, out_feature_class, {group_field}, {disable_optimization}, {output_all}, {out_table})
NameErläuterungDatentyp
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.

  • ENABLEDie Eingabedaten werden optimiert. Das Gruppierungsfeld wird ignoriert. Dies ist die Standardeinstellung.
  • DISABLEDie Eingabedaten werden nicht optimiert. Features werden in einem einzigen Ausgabe-Feature gespeichert oder gemäß dem Gruppierungsfeld vereinigt, falls eines bereitgestellt wird.
Boolean
output_all
(optional)

Legt fest, ob die Ausgabe-Feature-Class alle Features enthält oder nur die überlappenden Features, die vereinigt wurden.

  • ENABLEAlle Eingabe-Features werden in die Ausgabe geschrieben. Dies ist die Standardeinstellung.
  • DISABLENur vereinigte Features werden in die Ausgabe geschrieben. Nicht überlappende Features werden ignoriert.
Boolean
out_table
(optional)

Eine Viele-zu-Eins-Tabelle, die die Eingabe-Features identifiziert, die zur jeweiligen Ausgabe beitragen.

Table

Codebeispiel

Union3D – Beispiel 1 (Python-Fenster)

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')
Union3D – Beispiel 2 (eigenständiges Skript)

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)

Verwandte Themen