ArcMap

Vereinigen 3D

Zusammenfassung

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

Abbildung

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.

  • Multipatch-Features, die überlappende Volumina umfassen, werden durch Schneiden der Hüllen der Features sowie durch Entfernen der redundanten inneren Teile kombiniert. 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.

Syntax

Union3D(in_feature_class, out_feature_class, {group_field}, {disable_optimization}, {output_all}, {out_table})
ParameterErklärungDatentyp
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 zum Identifizieren der Features, die zusammen gruppiert werden sollen.

Field
disable_optimization
(optional)

Legt fest, ob die Eingabe-Daten optimiert werden oder nicht. Beim Optimieren werden die Eingabedaten vorbereitet, indem sie gruppiert werden, um die Performance zu verbessern und eindeutige Ausgaben für jeden Satz von überlappenden Features zu erstellen.

  • ENABLE —Optimierung ist aktiviert und das Gruppierungsfeld wird ignoriert. Dies ist die Standardeinstellung. Dies ist die Standardeinstellung.
  • DISABLE —Die 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 diejenigen, die die vereinigten Features überlappen.

  • ENABLE —Alle Eingabe-Features werden in die Ausgabe geschrieben. Dies ist die Standardeinstellung.
  • DISABLE —Nur 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 zu jeder Ausgabe beitragen.

Table

Codebeispiel

Union3D – 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'
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
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)

Umgebungen

Lizenzinformationen

  • Basic: Erfordert 3D Analyst
  • Standard: Erfordert 3D Analyst
  • Advanced: Erfordert 3D Analyst

Verwandte Themen