Mit der Spatial Analyst-Lizenz verfügbar.
Mit der 3D Analyst-Lizenz verfügbar.
Zusammenfassung
Berechnet die Krümmung einer Raster-Oberfläche, optional mit Vertikal- und Horizontalkrümmung.
Weitere Informationen zur Funktionsweise des Werkzeugs "Krümmung"
Verwendung
Die wichtigste Ausgabe ist die Krümmung der Oberfläche auf Zellenbasis, die durch die Zelle selbst und die acht angrenzenden Zellen definiert wird. Krümmung ist die zweite Ableitung der Oberfläche oder die "Neigung der Neigung". Es sind zwei optionale Ausgabekrümmungstypen möglich: die Vertikalkrümmung in Richtung der maximalen Neigung und die Horizontalkrümmung senkrecht zur Richtung der maximalen Neigung.
Eine positive Krümmung gibt an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konvex ist. Eine negative Krümmung gibt an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konkav ist. Der Wert 0 gibt an, dass die Oberfläche eben ist.
Bei der Vertikalausgabe gibt ein negativer Wert an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konvex ist. Eine positive Vertikalkrümmung gibt an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konkav ist. Der Wert 0 gibt an, dass die Oberfläche eben ist.
Bei der Horizontalausgabe gibt ein positiver Wert an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konvex ist. Eine negative Horizontalkrümmung gibt an, dass die Oberfläche in dieser Zelle aufwärts gerichtet konkav ist. Der Wert 0 gibt an, dass die Oberfläche eben ist.
Die Einheiten des Ausgabe-Krümmungs-Rasters sowie die Einheiten für das optionale Ausgabe-Raster der Vertikalkrümmung und das optionale Ausgabe-Raster der Horizontalkrümmung sind ein Hundertstel (1/100) einer Z-Einheit. Die normalerweise erwarteten Werte aller drei Ausgabe-Raster für ein hügeliges Gebiet (mäßige Geländekonturen) können zwischen -0,5 und 0,5 variieren. Bei schroff abfallenden Bergen (extreme Geländekonturen) können die Werte zwischen -4 und 4 variieren. Beachten Sie, dass diese Bereiche für bestimmte Raster-Oberflächen überschritten werden können.
Wenn das Eingabe-Raster neu berechnet werden muss, wird die bilineare Technik verwendet. Ein Eingabe-Raster muss beispielsweise dann neu berechnet werden, wenn das Ausgabe-Koordinatensystem, die Ausdehnung oder die Zellengröße sich von dem entsprechenden Wert der Eingabe unterscheidet.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
Curvature (in_raster, {z_factor}, {out_profile_curve_raster}, {out_plan_curve_raster})
Parameter | Erläuterung | Datentyp |
in_raster | Das Eingabe-Oberflächen-Raster. | 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. Dies ist 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 |
out_profile_curve_raster (optional) | Dataset des Ausgabe-Rasters der Vertikalkrümmung. Dies ist die Krümmung der Oberfläche in Neigungsrichtung. Es weist den Typ "Gleitkomma" auf. | Raster Dataset |
out_plan_curve_raster (optional) | Dataset des Ausgabe-Rasters der Horizontalkrümmung. Dies ist die Krümmung der Oberfläche senkrecht zur Neigungsrichtung. Es weist den Typ "Gleitkomma" auf. | Raster Dataset |
Rückgabewert
Name | Erläuterung | Datentyp |
out_curvature_raster | Das Ausgabe-Krümmungs-Raster. Es weist den Typ "Gleitkomma" auf. | Raster |
Codebeispiel
Curvature – Beispiel 1 (Python-Fenster)
In diesem Beispiel wird ein Krümmungs-Raster aus einem Eingabe-Oberflächen-Raster erstellt und auch ein Z-Faktor angewendet.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCurve = Curvature("elevation", 1.094)
outCurve.save("C:/sapyexamples/output/outcurv01")
Curvature – Beispiel 2 (eigenständiges Skript)
In diesem Beispiel wird ein Krümmungs-Raster aus einem Eingabe-Oberflächen-Raster erstellt und auch ein Z-Faktor angewendet.
# Name: Curvature_Ex_02.py
# Description: Calculates the curvature of a raster surface,
# optionally including profile and plan curvature.
# 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
inRaster = "elevation"
zFactor = 1.094
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Curvature
outCurve = Curvature(inRaster, 1.094)
# Save the output
outCurve.save("C:/sapyexamples/output/outcurv02")
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Erfordert Spatial Analyst oder 3D Analyst
- ArcGIS Desktop Standard: Erfordert Spatial Analyst oder 3D Analyst
- ArcGIS Desktop Advanced: Erfordert Spatial Analyst oder 3D Analyst