Minimales Begrenzungsvolumen (3D Analyst Tools)

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 resultierende 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

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 werden soll.	Feature Class
Typ der Ausgabe-Feature-Class (Optional)	Legt fest, welche Methode zum Bestimmen der Geometrie des minimalen Begrenzungsvolumens verwendet wird. Convex hull—The smallest convex region surrounding the input data. Sphere—The smallest sphere enclosing the input data. Envelope—The XYZ extent of the input data. Concave hull—The concave hull that encloses the input data.	String
Gruppenoptionen (Optional)	Gibt an, wie die Eingabe-Features gruppiert werden; jede Gruppe wird mit einem Ausgabe-Multipatch umschlossen. None—Input features will not be grouped. This is the default. This option is not available for point input. All—All input features will be treated as one group. List—Input features will be grouped based on their common values in the specified field or fields in the group field parameter.	String
Gruppenfeld(er) (Optional)	Das bzw. die Felder der Eingabe-Features, nach dem bzw. denen Features bei Auswahl von Liste unter Gruppierungsoption als Liste gruppiert werden. Für die Option Liste 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 geometrische Attribute der Ausgabe-Multipatch-Feature-Class hinzugefügt werden. Aktiviert—Geometric attributes will be added to the output feature. Deaktiviert—No geometric attributes will be added to the output feature. This is the default.	Boolean

arcpy.3d.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 werden soll.	Feature Class
geometry_type (Optional)	Legt fest, welche Methode zum Bestimmen der Geometrie des minimalen Begrenzungsvolumens verwendet wird. `CONVEX_HULL`—The smallest convex region surrounding the input data. `SPHERE`—The smallest sphere enclosing the input data. `ENVELOPE`—The XYZ extent of the input data. `CONCAVE_HULL`—The concave hull that encloses the input data.	String
group (Optional)	Gibt an, wie die Eingabe-Features gruppiert werden; jede Gruppe wird mit einem Ausgabe-Multipatch umschlossen. `NONE`—Input features will not be grouped. This is the default. This option is not available for point input. `ALL`—All input features will be treated as one group. `LIST`—Input features will be grouped based on their common values in the specified field or fields in the group field parameter.	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 geometrische Attribute der Ausgabe-Multipatch-Feature-Class hinzugefügt werden. `MBV_FIELDS`—Geometric attributes will be added to the output feature. `NO_MBV_FIELDS`—No geometric attributes will be added to the output feature. This is the default.	Boolean

Codebeispiel

MinimumBoundingVolume: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

import arcpy
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.ddd.MinimumBoundingVolume(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

Lizenzierungsinformationen

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