Krümmung (Spatial Analyst)
Zusammenfassung
Hiermit wird die Krümmung einer Raster-Oberfläche berechnet, 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 um -0,5 bis 0,5 abweichen. Bei schroff abfallenden Bergen (extreme Geländekonturen) können die Werte zwischen -4 und 4 variieren. Beachten Sie, dass dieser Bereich für bestimmte Raster-Oberflächen überschritten werden kann.
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.
Syntax
| 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. 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 |
out_profile_curve_raster (optional) |
Dataset des Ausgabe-Rasters der Vertikalkrümmung. Dies ist die Krümmung der Oberfläche in Neigungsrichtung. | 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. | Raster Dataset |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_curvature_raster |
Das Ausgabe-Krümmungs-Raster. | 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
# 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")