Minimales Begrenzungsvolumen (3D Analyst)

Zusammenfassung

Erstellt Multipatch-Features, die das Raumvolumen darstellen, das von einem Satz von 3D-Features eingenommen wird.

Abbildung

Minimales Begrenzungsvolumen

Verwendung

  • Sie können die Methode Kugel oder Envelope (geometry_type="SPHERE" oder geometry_type = "ENVELOPE" in Python) verwenden, um eine schnelle Darstellung des Raumvolumens abzurufen, das von einem Satz von 3D-Features eingenommen wird.

  • Die Option Konvexe Hülle (geometry_type="CONVEX_HULL" in Python) ist detailreicher als die Methode Kugel oder Envelope, erfasst jedoch keine lokalen Mulden in den Eingabe-Features.

  • Die Option Konkave Hülle (geometry_type="CONCAVE_HULL" in Python) bietet die größte Detailgenauigkeit hinsichtlich der Form des Begrenzungsvolumens, ist jedoch sehr rechenintensiv und sollte nicht bei großen Eingabe-Datenmengen verwendet werden.

  • Wenn das minimale Begrenzungsvolumen Gruppen von Eingabe-Features darstellt, werden die zum Trennen der Eingabe verwendeten Felder dem resultierenden Multipatch hinzugefügt. Wenn die Geometrieeigenschaften im minimalen Begrenzungsvolumen enthalten sind, werden die folgenden Felder den Ausgabe-Features hinzugefügt:

    • MBV_Area: Die Gesamtoberfläche des minimalen Begrenzungsvolumens
    • MBV_Volume: Das Gesamtvolumen des im Multipatch-Feature enthaltenen Raums

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Das LAS-Dataset oder die 3D-Features, deren minimales Begrenzungsvolumen ausgewertet wird.

LAS Dataset Layer; Feature Layer
Z-Wert

Die Quelle der Z-Werte für die Eingabedaten.

Field
Ausgabe-Feature-Class

Die Feature-Class, die erstellt wird.

Feature Class
Typ der Ausgabe-Feature-Class
(optional)

Gibt die Methode an, die zur Ermittlung der Geometrie des minimalen Begrenzungsvolumens verwendet wird.

  • Konvexe HülleDie kleinste konvexe Region, die die Eingabedaten umgibt.
  • KugelDie kleinste Kugel, die die Eingabedaten umschließt.
  • EnvelopeDie XYZ-Ausdehnung der Eingabedaten.
  • Konkave HülleDie konkave Hülle umschließt die Eingabedaten.
String
Gruppenoptionen
(optional)

Gibt an, wie die Eingabe-Features gruppiert werden; jede Gruppe wird mit einem Ausgabe-Multipatch umschlossen.

  • KeineEingabe-Features werden nicht gruppiert. Dies ist die Standardeinstellung. Diese Option ist für Punkteingaben nicht verfügbar.
  • AlleAlle Eingabe-Features werden als eine Gruppe behandelt.
  • ListeEingabe-Features werden auf Grundlage ihrer allgemeinen Werte im angegebenen Feld oder den Feldern im Gruppenfeldparameter gruppiert.
String
Gruppenfeld(er)
(optional)

Das bzw. die Felder der Eingabe-Features, nach dem bzw. denen Features bei Auswahl von Liste als Gruppenoption gruppiert werden. Für die Option List ist mindestens ein Gruppenfeld erforderlich. Alle Features, die im angegebenen Feld bzw. den Feldern den gleichen Wert haben, werden als Gruppe behandelt.

Field
Geometrieeigenschaften als Attribute zur Ausgabe hinzufügen
(optional)

Gibt an, ob den einzelnen Features das Volumen und die Oberfläche des minimalen Begrenzungsvolumens zugeordnet wird.

  • Deaktiviert: Dem Ausgabe-Feature werden keine geometrischen Attribute hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Dem Ausgabe-Feature werden geometrische Attribute hinzugefügt.
Boolean

arcpy.ddd.MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})
NameErläuterungDatentyp
in_features

Das LAS-Dataset oder die 3D-Features, deren minimales Begrenzungsvolumen ausgewertet wird.

LAS Dataset Layer; Feature Layer
z_value

Die Quelle der Z-Werte für die Eingabedaten.

Field
out_feature_class

Die Feature-Class, die erstellt wird.

Feature Class
geometry_type
(optional)

Gibt die Methode an, die zur Ermittlung der Geometrie des minimalen Begrenzungsvolumens verwendet wird.

  • CONVEX_HULLDie kleinste konvexe Region, die die Eingabedaten umgibt.
  • SPHEREDie kleinste Kugel, die die Eingabedaten umschließt.
  • ENVELOPEDie XYZ-Ausdehnung der Eingabedaten.
  • CONCAVE_HULLDie konkave Hülle umschließt die Eingabedaten.
String
group
(optional)

Gibt an, wie die Eingabe-Features gruppiert werden; jede Gruppe wird mit einem Ausgabe-Multipatch umschlossen.

  • NONEEingabe-Features werden nicht gruppiert. Dies ist die Standardeinstellung. Diese Option ist für Punkteingaben nicht verfügbar.
  • ALLAlle Eingabe-Features werden als eine Gruppe behandelt.
  • LISTEingabe-Features werden auf Grundlage ihrer allgemeinen Werte im angegebenen Feld oder den Feldern im Gruppenfeldparameter gruppiert.
String
group_field
[group_field,...]
(optional)

Das bzw. die Felder der Eingabe-Features, nach dem bzw. denen Features bei Auswahl von LIST als group_option gruppiert werden. Für die Option LIST ist mindestens ein Gruppenfeld erforderlich. Alle Features, die im angegebenen Feld bzw. den Feldern den gleichen Wert haben, werden als Gruppe behandelt.

Field
mbv_fields
(optional)

Gibt an, ob der Ausgabe-Multipatch-Feature-Class geometrische Attribute hinzugefügt werden.

  • NO_MBV_FIELDSDem Ausgabe-Feature werden keine geometrischen Attribute hinzugefügt. Dies ist die Standardeinstellung.
  • MBV_FIELDSDem Ausgabe-Feature werden geometrische Attribute hinzugefügt.
Boolean

Codebeispiel

MinimumBoundingVolume - Beispiel 1 (Python-Fenster)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = 'C:/data'
arcpy.ddd.MinimumBoundingVolume('tree_canopy.shp', 'Shape.Z', 
                                'canopy_volume.shp', 'CONCAVE_HULL',
                                group='List', group_field='Season'
                                mbv_fields='MBV_FIELDS')
MinimumBoundingVolume - Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

'''****************************************************************************
Name: Detect Periods of Activity
Description: 
****************************************************************************'''
# Import system modules
import arcpy
import tempfile
import math

in_features = arcpy.GetParameterAsText(0)
out_volume = arcpy.GetParameterAsText(1)
grouping_field = arcpy.GetParameterAsText(2)


try:
    arcpy.MinimumBoundingVolume_3d(in_features, 'Shape.Z', out_volume, 
                                   'CONCAVE_HULL','LIST', group_field)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Lizenzinformationen

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

Verwandte Themen