Oberflächenvolumen (3D Analyst Tools)

Zusammenfassung

Berechnet die Fläche und das Volumen der Region zwischen einer Oberfläche und einer Referenzebene.

Abbildung

Abbildung des Werkzeugs "Oberflächenvolumen"

Verwendung

Verwenden Sie den Parameter Z-Faktor, um die Genauigkeit von Volumenberechnungen sicherzustellen, wenn die Z-Oberflächenwerte in einer anderen Maßeinheit als die XY-Einheiten vorliegen. Durch den Parameter Z-Faktor werden die Originaldaten nicht geändert. Das Werkzeug legt automatisch den entsprechenden Z-Faktor fest, wenn die XY- und Z-Koordinatensysteme definiert wurden.

Die Ausgabetextdatei speichert den vollständigen Pfad zu der Oberfläche, die zum Erstellen der Ergebnisse verwendeten Parameter sowie die berechnete Fläche und die Volumenmessungen. Wenn dieselbe Ausgabedatei bei mehreren Ausführungen des Werkzeugs angegeben wird, werden die bereits vorhandenen Datensätze beibehalten und die Ergebnisse wie im folgenden Beispiel gezeigt an die Tabelle angehängt:


Dataset	Ebenenhöhe	Referenz	Z-Faktor	2D-Fläche	3D-Fläche	Volume
C:\data\tin	100.00	Oberhalb	1	15984467.82	16354331.40	1886012931.05
C:\data\raster.tif	250.5	Unterhalb	3.28084	0	0	0
C:\data.gdb\fd\terrain	1250	Oberhalb	0.3048	1854238.36	1970550.88	1099221466.89

Wenn es sich bei dem Bereich für die Berechnungen um eine nicht rechteckige Ausdehnung handelt, definieren Sie die Region mithilfe eines Polygons. Verwenden Sie anschließend das Werkzeug Polygon-Volumen, um die Berechnungen zu bestimmen.
Eine Raster-Oberfläche wird, im Gegensatz zu der Ausdehnung des gesamten Zellenbereichs, anhand der Ausdehnung des Mittelpunktes jeder Zelle ausgewertet. Die resultierende Analyse verkleinert die Datenfläche des Rasters um eine halbe Zelle relativ zu der Datenfläche, die für das Raster angezeigt wird.

Beschriftung	Erläuterung	Datentyp
Eingabe-Oberfläche	Die Oberfläche des Rasters, TIN oder Terrains, die verarbeitet wird.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Ausgabetextdatei (Optional)	Eine kommagetrennte ASCII-Textdatei, die die Flächen- und Volumenberechnungen enthält. Wenn die Datei bereits vorhanden ist, werden die Ergebnisse an die Datei angefügt.	File
Referenzebene (Optional)	Gibt die Richtung von der Bezugsebene an, die für die Berechnung der Ergebnisse verwendet wird. Above the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. Below the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
Ebenenhöhe (Optional)	Der Z-Wert der Ebene, die zur Berechnung von Fläche und Volumen dient.	Double
Z-Faktor (Optional)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
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

arcpy.3d.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})

Name	Erläuterung	Datentyp
in_surface	Die Oberfläche des Rasters, TIN oder Terrains, die verarbeitet wird.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_text_file (Optional)	Eine kommagetrennte ASCII-Textdatei, die die Flächen- und Volumenberechnungen enthält. Wenn die Datei bereits vorhanden ist, werden die Ergebnisse an die Datei angefügt.	File
reference_plane (Optional)	Gibt die Richtung von der Bezugsebene an, die für die Berechnung der Ergebnisse verwendet wird. `ABOVE`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. `BELOW`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
base_z (Optional)	Der Z-Wert der Ebene, die zur Berechnung von Fläche und Volumen dient.	Double
z_factor (Optional)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
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

Codebeispiel

SurfaceVolume: Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceVolume("sample.gdb/featuredataset/terrain", "surf_vol.txt",
                       reference_plane="ABOVE", base_z=300, z_factor=3.24,
                       pyramid_level_resolution=5)

SurfaceVolume: Beispiel 2 (eigenständiges Skript)

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

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

****************************************************************************'''
# Import system modules
import arcpy

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

# Set Local Variables
inSurface = "elevation_tin"

# Run SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

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