Oberflächenvolumen (3D Analyst)
Zusammenfassung
Berechnet die Fläche und das Volumen der Oberfläche eines Rasters, TINs (Triangulated Irregular Network, Unregelmäßiges Dreiecksnetz) oder Terrain-Datasets ober- oder unterhalb einer gegebenen Referenzebene.
Weitere Informationen zur Funktionsweise von "Oberflächenvolumen"
Abbildung
 |
Verwendung
-
Sie haben die Möglichkeit, das Volumen eines angegebenen Teiles eines TINs oder einer Terrain-Dataset-Oberfläche mit dem Werkzeug "Polygon-Volumen" zu bestimmen.
-
Der Z-Faktor ist zur Berichtigung von Volumenberechnungen erforderlich, wenn die Z-Oberflächeneinheiten in einer anderen Maßeinheit als die Geländeeinheiten ausgedrückt werden. Die Originaldaten werden durch den Z-Faktor nicht verändert.
Ein Raster-DEM besteht aus gleichmäßig angeordneten Punkten und nicht aus Zellen wie ein Bild. Die vom Werkzeug Oberflächenvolumen durchgeführte Flächenberechnung basiert auf der Ausdehnung der gleichmäßig angeordneten Punkte des DEMs und nicht auf der Ausdehnung der Zellen. Da diese Berechnung auf Punkten und nicht auf Zellen basiert, ist der Datenbereich für das Raster-DEM um eine halbe Zelle kleiner als der als Raster-Bild angezeigte Datenbereich.
Syntax
| Parameter | Erläuterung | Datentyp |
in_surface |
Die Eingabe-Raster-, -TIN- oder -Terrain-Dataset-Oberfläche, die zur Berechnung von Fläche und Volumen verwendet wird. | Raster Layer; Terrain Layer; TIN Layer |
out_text_file (optional) |
Die optionale Ausgabetextdatei, die die Ergebnisse enthält. | File |
reference_plane (optional) |
Wählen Sie, ob die Berechnung über- oder unterhalb einer bestimmten Höhe erfolgen soll.
| String |
base_z (optional) |
Die Höhe der Ebene, die zur Berechnung von Fläche und Volumen dient. | Double |
z_factor (optional) |
Der Faktor, mit dem die Höhen der Eingabeoberfläche multipliziert werden, um das Oberflächenvolumen zu berechnen. Dient zum Umrechnen der Z-Einheiten in XY-Einheiten. | Double |
pyramid_level_resolution (optional) |
Die Auflösung der Pyramidenebene des Terrain-Datasets, die für die Geoverarbeitung verwendet werden soll. Der Standardwert ist 0, also volle Auflösung. | 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.SurfaceVolume_3d("sample.gdb/featuredataset/terrain", "surf_vol.txt",
"ABOVE", 300, 1, 5)
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
Name: Surface Volume Example
Description: This script demonstrates how to use the
Surface Volume tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "elevation_tin"
#Execute SurfaceVolume
result = arcpy.SurfaceVolume_3d(inSurface, "", "ABOVE", "300", "1", "5")
print result.GetMessage(0)
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)