Minimales Begrenzungsvolumen (3D Analyst)—ArcGIS Pro

Zusammenfassung

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

Abbildung

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

Beschriftung	Erläuterung	Datentyp
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ülle—Die kleinste konvexe Region, die die Eingabedaten umgibt. Kugel—Die kleinste Kugel, die die Eingabedaten umschließt. Envelope—Die XYZ-Ausdehnung der Eingabedaten. Konkave Hülle—Die 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. Keine—Eingabe-Features werden nicht gruppiert. Dies ist die Standardeinstellung. Diese Option ist für Punkteingaben nicht verfügbar. Alle—Alle Eingabe-Features werden als eine Gruppe behandelt. Liste—Eingabe-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})

Name	Erläuterung	Datentyp
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_HULL—Die kleinste konvexe Region, die die Eingabedaten umgibt. SPHERE—Die kleinste Kugel, die die Eingabedaten umschließt. ENVELOPE—Die XYZ-Ausdehnung der Eingabedaten. CONCAVE_HULL—Die 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. NONE—Eingabe-Features werden nicht gruppiert. Dies ist die Standardeinstellung. Diese Option ist für Punkteingaben nicht verfügbar. ALL—Alle Eingabe-Features werden als eine Gruppe behandelt. LIST—Eingabe-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_FIELDS—Dem Ausgabe-Feature werden keine geometrischen Attribute hinzugefügt. Dies ist die Standardeinstellung. MBV_FIELDS—Dem 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())

Umgebungen

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen

Lizenzinformationen

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