Abtrag/Auftrag (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Berechnet die Volumenänderung zwischen zwei Oberflächen. Dieses Werkzeug wird in der Regel für Ab- und Auftragsvorgänge verwendet.

Weitere Informationen zur Funktionsweise des Werkzeugs "Abtrag/Auftrag"

Bild

Abbildung "Abtrag/Auftrag"
OutRas = CutFill(Before_Ras, After_Ras)
Abbildung "Felder von Abtrag/Auftrag"
Wenn der Abtrags-/Auftragsvorgang durchgeführt wird, wird standardmäßig ein spezieller Renderer auf den Layer angewendet, der die Positionen des Abtrags und des Auftrags hervorhebt. Die bestimmende Größe hierfür ist in der Attributtabelle des Ausgabe-Rasters enthalten: Ein negativer Volumenwert weist auf Flächen mit Auftrag (Material wurde hinzugefügt) hin, während ein positiver Volumenwert auf Bereiche hinweist, in denen Material abgetragen (entfernt) wurde.

Verwendung

Syntax

CutFill (in_before_surface, in_after_surface, {z_factor})
ParameterErläuterungDatentyp
in_before_surface

Die Eingabe, die die Oberfläche vor der Abtrags- bzw. Auftragsoperation repräsentiert.

Raster Layer
in_after_surface

Die Eingabe, die die Oberfläche nach der Abtrags- bzw. Auftragsoperation repräsentiert.

Raster Layer
z_factor
(optional)

Anzahl der XY-Geländeeinheiten in einer Z-Oberflächeneinheit.

Durch den Z-Faktor werden die Maßeinheiten der Z-Einheiten angepasst, falls sie sich von den XY-Einheiten der Eingabe-Oberfläche unterscheiden. Die Z-Werte der Eingabe-Oberfläche werden bei der Berechnung der endgültigen Ausgabe-Oberfläche mit dem Z-Faktor multipliziert.

Falls die XY-Einheiten und die Z-Einheiten in denselben Maßeinheiten ausgedrückt sind, lautet der Z-Faktor 1. Hierbei handelt es sich um die Standardeinstellung.

Wenn die XY- und Z-Einheiten unterschiedliche Maßeinheiten aufweisen, muss der Z-Faktor entsprechend festgelegt werden, da andernfalls falsche Ergebnisse erzielt werden. Beispiel: Wenn die Z-Einheiten in Fuß und die XY-Einheiten in Metern angegeben sind, müssen Sie den Z-Faktor "0,3048" wählen, um die Z-Einheiten von Fuß in Meter umzurechnen (1 Fuß = 0,3048 Meter).

Double

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster, das Regionen mit Auftrag und Abtrag definiert.

Die Werte zeigen die Positionen und Beträge, an denen Oberfläche hinzugefügt oder entfernt wurde.

Raster

Codebeispiel

CutFill – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden das Volumen und die Fläche von Abtrags- und Auftragsorten berechnet, und das Ergebnis wird als Grid-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCutFill = CutFill("elevation01", "elevation02", 1)
outCutFill.save("C:/sapyexamples/output/outcutfill01")
CutFill – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden das Volumen und die Fläche von Abtrags- und Auftragsorten berechnet, und das Ergebnis wird als Grid-Raster ausgegeben.

# Name: Cutfill_Ex_02.py
# Description: Calculates the volume and area of cut and 
#              fill locations.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set local variables
inBeforeRaster = "elevation01"
inAfterRaster =  "elevation02"
zFactor = 0.5

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute CutFill
outCutFill = CutFill(inBeforeRaster, inAfterRaster, zFactor)

# Save the output 
outCutFill.save("C:/sapyexamples/output/outcutfill02")

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst oder 3D Analyst
6/5/2014