Polygon-Volumen (3D Analyst)
Zusammenfassung
Berechnet das Volumen und die Oberfläche zwischen einem Polygon und einer Terrain- oder TIN-Oberfläche.
Verwendung
-
Berechnungen werden nur für die Teile der Eingabepolygone und der Oberfläche des TIN- oder Terrain-Datasets vorgenommen, die sich überschneiden.
Jede Polygongrenze wird zunächst mit der Interpolationszone der Oberfläche verschnitten. Dadurch wird der gemeinsame Bereich zwischen den beiden identifiziert. Anschließend werden für alle Dreiecke und Teile davon, die in das geschnittene Polygon fallen, Volumen und Oberfläche berechnet.
Das Volumen stellt die kubische Fläche zwischen dem ausgewählten Teil der Oberfläche und einer horizontalen Ebene dar, die sich auf der im Parameter Höhenfeld angegebenen Höhe befindet.
- ABOVE – Das Volumen wird zwischen der Ebene und der Unterseite der Oberfläche berechnet.
- BELOW – Das Volumen wird zwischen der Ebene und der Oberseite der Oberfläche berechnet. Der Oberflächenbereich für denselben Teil der Oberfläche wird ebenfalls berechnet.
Syntax
| Parameter | Erläuterung | Datentyp |
in_surface |
Das Eingabe-Terrain oder die TIN-Oberfläche. | Tin Layer; Terrain Layer |
in_feature_class |
Die Eingabe-Polygon-Feature-Class. | 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) |
Bestimmt, wie Volumen und Oberfläche berechnet werden.
| String |
out_volume_field (optional) |
Der Name des Feldes in der Ausgabe, in dem das in der Analyse berechnete Volumen gespeichert wird. Die Standardeinstellung ist "Volume". | String |
surface_area_field (optional) |
Der Name des Feldes in der Ausgabe, in dem die in der Analyse berechnete Oberfläche gespeichert wird. Die Standardeinstellung ist "SArea". | String |
pyramid_level_resolution (optional) |
The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution. | Double |
Codebeispiel
The following sample demonstrates the use of this tool in the Python window:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PolygonVolume_3d("sample.gdb/featuredataset/terrain", "polygon.shp", "<None>", "ABOVE", "Volume", "SArea", "5")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
Name: PolygonVolume Example
Description: This script demonstrates how to use the
PolygonVolume tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# 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.PolygonVolume_3d(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)