Polygon-Volumen (3D Analyst)

Zusammenfassung

Berechnet das Volumen und die Oberfläche zwischen einem Polygon konstanter Höhe und einer Oberfläche.

Verwendung

  • Zuerst schneidet jedes Polygon die Oberfläche. Anschließend werden für alle Dreiecke der Oberfläche und Teile davon, die in das geschnittene Polygon fallen, Volumen und Oberfläche berechnet. Wenn Berechnungen basierend auf einer Ausdehnung für Ihre Anforderungen geeignet sind, können Sie das Werkzeug Oberflächenvolumen um schneller Ergebnisse zu erhalten.

  • Die Fläche der Oberfläche stellt die Teile der Oberfläche dar, die sich oberhalb oder unterhalb der Höhe der Polygon-Features befinden. Das Volumen stellt die Region zwischen der Oberfläche und dem Raum oberhalb oder unterhalb der Höhe des Polygon-Features dar. Bei Berechnungen oberhalb der Ebene stellt das Volumen die Region zwischen der Ebene und der Unterseite der Oberfläche dar. Bei Berechnungen unterhalb der Ebene stellt das Volumen die Region zwischen der Ebene und der Oberseite der Oberfläche dar.

  • Die Eingabeoberfläche wird als unregelmäßiges Dreiecksnetz (Triangulated Irregular Network, TIN) ausgewertet. Ein LAS-Dataset wird als Oberfläche verarbeitet, indem aus dem LAS-Dataset ein TIN konstruiert wird. Da LAS-Datasets in der Regel große Mengen an Punkten enthalten, kann die Konstruktion der temporären Oberfläche, die für die Analyse verwendet wird, bei der Verarbeitung viel Zeit in Anspruch nehmen, wenn das Eingabe-Polygon eine große Anzahl an Punkten abdeckt. In diesem Fall können Sie mit dem Werkzeug LAS-Dataset in TIN ein ausgedünntes TIN aus dem LAS-Dataset exportieren.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Oberfläche

Die TIN-, Terrain- oder LAS-Dataset-Oberfläche, die verarbeitet wird.

LAS Dataset Layer; Terrain Layer; TIN Layer
Eingabe-Polygone

Die Polygon-Features, die die Region definieren, die verarbeitet wird.

Feature Layer
Höhenfeld

Das Feld in der Attributtabelle des Polygons, durch das die Höhe der Referenzebene definiert wird, die für Volumenberechnungen herangezogen wird.

String
Referenzebene
(optional)

Legt die Richtung von der Referenzebene fest, in die Volumen und Oberfläche berechnet werden.

  • Oberhalb der Ebene berechnenVolumen und Oberfläche werden oberhalb der Höhe der Referenzebene der Polygone berechnet.
  • Unterhalb der Ebene berechnenVolumen und Oberfläche werden unterhalb der Höhe der Referenzebene der Polygone berechnet. Dies ist die Standardeinstellung.
  • Oberhalb und unterhalb der Ebene berechnenVolumen und Oberfläche werden oberhalb und unterhalb der Höhe der Referenzebene der Polygone berechnet.
String
Volumenfeld
(optional)

Der Name des Feldes, das Volumenberechnungen enthalten soll. Die Standardeinstellung ist Volume.

String
Oberflächenfeld
(optional)

Der Name des Feldes, das die Oberflächenerechnungen enthalten soll. Die Standardeinstellung ist SArea.

String
Auflösung der Pyramidenebene
(optional)

Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.

Double
Volumenfeld
(optional)

Der Name des Feldes, das das oberhalb der Polygonhöhe berechnete Volumen enthält. Die Standardeinstellung ist Above_Vol.

String
Volumenfeld
(optional)

Der Name des Feldes, das das unterhalb der Polygonhöhe berechnete Volumen enthält. Die Standardeinstellung ist Below_Vol.

String
Oberfläche oberhalb des Feldes
(optional)

Der Name des Feldes, das die oberhalb der Polygonhöhe berechnete Oberfläche enthält. Die Standardeinstellung ist Above_SA.

String
Oberfläche unterhalb des Feldes
(optional)

Der Name des Feldes, das die unterhalb der Polygonhöhe berechnete Oberfläche enthält. Die Standardeinstellung ist Below_SA.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Feature-Class

Die Ausgabe-Features, die aktualisiert werden.

Feature Layer

arcpy.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution}, {out_volume_above_field}, {out_volume_below_field}, {surface_area_above_field}, {surface_area_below_field})
NameErläuterungDatentyp
in_surface

Die TIN-, Terrain- oder LAS-Dataset-Oberfläche, die verarbeitet wird.

LAS Dataset Layer; Terrain Layer; TIN Layer
in_feature_class

Die Polygon-Features, die die Region definieren, die verarbeitet wird.

Feature Layer
in_height_field

Das Feld in der Attributtabelle des Polygons, durch das die Höhe der Referenzebene definiert wird, die für Volumenberechnungen herangezogen wird.

String
reference_plane
(optional)

Legt die Richtung von der Referenzebene fest, in die Volumen und Oberfläche berechnet werden.

  • ABOVEVolumen und Oberfläche werden oberhalb der Höhe der Referenzebene der Polygone berechnet.
  • BELOWVolumen und Oberfläche werden unterhalb der Höhe der Referenzebene der Polygone berechnet. Dies ist die Standardeinstellung.
  • BOTHVolumen und Oberfläche werden oberhalb und unterhalb der Höhe der Referenzebene der Polygone berechnet.
String
out_volume_field
(optional)

Der Name des Feldes, das Volumenberechnungen enthalten soll. Die Standardeinstellung ist Volume.

String
surface_area_field
(optional)

Der Name des Feldes, das die Oberflächenerechnungen enthalten soll. Die Standardeinstellung ist SArea.

String
pyramid_level_resolution
(optional)

Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.

Double
out_volume_above_field
(optional)

Der Name des Feldes, das das oberhalb der Polygonhöhe berechnete Volumen enthält. Die Standardeinstellung ist Above_Vol.

String
out_volume_below_field
(optional)

Der Name des Feldes, das das unterhalb der Polygonhöhe berechnete Volumen enthält. Die Standardeinstellung ist Below_Vol.

String
surface_area_above_field
(optional)

Der Name des Feldes, das die oberhalb der Polygonhöhe berechnete Oberfläche enthält. Die Standardeinstellung ist Above_SA.

String
surface_area_below_field
(optional)

Der Name des Feldes, das die unterhalb der Polygonhöhe berechnete Oberfläche enthält. Die Standardeinstellung ist Below_SA.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
output_feature_class

Die Ausgabe-Features, die aktualisiert werden.

Feature Layer

Codebeispiel

PolygonVolume: Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.PolygonVolume("sample.gdb/featuredataset/terrain", "cut_off_plane.shp", 
                       in_height_field="Z", reference_plane="ABOVE", 
                       pyramid_level_resolution="5")
PolygonVolume: Beispiel 2 (eigenständiges Skript)

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

'''****************************************************************************
Name: PolygonVolume Example
Description: This script demonstrates how to use the 
             PolygonVolume tool.
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"


# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
inPoly = "floodplain_100.shp"
zField = "Height"
refPlane = "BELOW"
volFld = "Volume"
sAreaFld = "SArea"

#Execute PolygonVolume
arcpy.ddd.PolygonVolume(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)

Lizenzinformationen

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

Verwandte Themen