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. 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.
Wenn der Wert des Parameters Eingabe-Raster (in_raster in Python) eine hohe Auflösung für eine geringere Zellengröße als einige Meter angibt oder besonders verrauscht ist, sollten Sie das Werkzeug Oberflächenparameter und seine Option für die benutzerdefinierte Nachbarschaftsentfernung statt seiner Option für unmittelbare 3x3-Nachbarschaft verwenden. Die Auswirkung verrauschter Oberflächen kann durch Verwendung einer größeren Nachbarschaft minimiert werden. Mit einer größeren Nachbarschaft lassen sich auch Terrains und Oberflächeneigenschaften besser darstellen, wenn Oberflächen mit hoher Auflösung verwendet werden.
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 | Erklärung | Datentyp |
in_raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
z_factor (optional) | Die 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 "Float" 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 "Float" auf. | Raster Dataset |
Rückgabewert
Name | Erklärung | Datentyp |
out_curvature_raster | Das Ausgabe-Krümmungs-Raster. Es weist den Typ "Float" auf. | Raster |
Codebeispiel
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")
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
# Execute Curvature
outCurve = Curvature(inRaster, 1.094)
# Save the output
outCurve.save("C:/sapyexamples/output/outcurv02")
Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst oder 3D Analyst
- Standard: Erfordert Spatial Analyst oder 3D Analyst
- Advanced: Erfordert Spatial Analyst oder 3D Analyst