Beschriftung | Erläuterung | Datentyp |
Eingabe-Raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
Ausgabe-Raster | Das Ausgabe-Neigungs-Raster. Es weist den Typ "Gleitkomma" auf. | Raster Dataset |
Ausgabe-Messwert (optional) | Hiermit werden die Maßeinheiten (Grad oder Prozent) des Ausgabe-Neigungs-Rasters angegeben.
| String |
Z-Faktor (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 |
Methode (optional) | Gibt an, ob die Berechnung mit einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode erfolgen soll. Die planare Methode eignet sich zum Berechnen lokaler Flächen in einer Projektion, bei der die korrekte Entfernung und Fläche beibehalten werden. Damit lassen sich Analysen von Flächen wie Städten, Landkreisen oder flächenmäßig kleineren Bundesstaaten durchführen. Die geodätische Methode liefert ein genaueres Ergebnis, allerdings fällt hierfür evtl. eine längere Verarbeitungszeit an.
| String |
Z-Einheit (optional) | Gibt die lineare Einheit an, die für vertikale Z-Werte verwendet werden soll. Sie wird durch ein vertikales Koordinatensystem definiert, sofern vorhanden. Falls kein vertikales Koordinatensystem vorhanden ist, müssen Sie die Z-Einheit mithilfe der Einheitenliste definieren, um eine korrekte geodätische Berechnung sicherzustellen. Die Standardeinstellung lautet Meter.
| String |
Zielgerät für Analyse (optional) | Gibt das Gerät an, das für die Berechnung verwendet wird.
| String |
Mit der Spatial Analyst-Lizenz verfügbar.
Mit der 3D Analyst-Lizenz verfügbar.
Zusammenfassung
Gibt die Neigung (Gradient oder Steilheit) jeder Zelle eines Rasters an.
Das Werkzeug Oberflächenparameter bietet eine neuere Implementierung und eine verbesserte Funktionalität.
Abbildung
Verwendung
Das Werkzeug Oberflächenparameter bietet eine neuere Implementierung der Neigung und sollte statt des Werkzeugs Neigung verwendet werden. Das Werkzeug Neigung passt eine Ebene an die neun lokalen Zellen an, aber eine Ebene ist möglicherweise kein guter Deskriptor der Landschaft und kann relevante natürliche Variationen maskieren oder überhöhen. Das Werkzeug Oberflächenparameter passt eine Oberfläche an die benachbarten Zellen an, nicht an eine Ebene. Dadurch ermöglicht es eine natürlichere Anpassung an das Terrain.
Das Werkzeug Neigung verwendet ein Fenster aus 3 mal 3 Zellen, um den Wert zu berechnen. Im Werkzeug Oberflächenparameter sind dagegen Fenstergrößen von 3 mal 3 bis 15 mal 15 Zellen möglich. Größere Fenster sind für Höhendaten mit hoher Auflösung nützlich, um Prozesse der Landoberfläche mit einem geeigneten Maßstab zu erfassen. Oberflächenparameter bietet zudem eine anpassungsfähige Fensteroption, die die lokale Variabilität des Terrains bewertet und die größte geeignete Nachbarschaftsgröße für jede Zelle identifiziert. Dies kann bei einem graduell homogenen Terrain, dass von Wasserläufen, Straßen oder tiefen Einschnitten in der Neigung unterbrochen ist, nützlich sein.
Sie können weiterhin dem traditionellen Ansatz des Werkzeugs Neigung folgen, wenn die Ergebnisse genau mit früheren Ausführungen des Werkzeugs übereinstimmen müssen oder wenn eine schnelle Ausführung wichtiger als ein besserer Algorithmus ist.
Dieses Werkzeug verwendet ein bewegliches 3x3-Zellen-Fenster zur Verarbeitung der Daten. Wenn die zu verarbeitende Zelle "NoData" lautet, dann wird für diese Position "NoData" ausgegeben.
Von den acht benachbarten Zellen der zu verarbeitenden Zelle müssen mindestens sieben einen gültigen Wert aufweisen, um vom Werkzeug verarbeitet zu werden. Sind weniger als sieben gültige Zellen vorhanden, erfolgt keine Berechnung, und die Ausgabe dieser zu verarbeitenden Zelle lautet "NoData".
Die Zellen der ganz am Rand des Ausgabe-Rasters befindlichen Zeilen und Spalten lauten "NoData". Das liegt daran, dass die Zellen entlang der Grenze des Eingabe-Datasets nicht an ausreichend viele andere Zellen angrenzen.
Der Wertebereich in der Ausgabe hängt vom Typ der Maßeinheiten ab.
- Für Grad können Neigungswerte von 0 bis 90 angegeben werden.
- Für Prozentanstiege können Werte von 0 bis zu theoretisch unendlich angegeben werden. Eine flache Oberfläche entspricht 0 Prozent, eine Oberfläche mit 45 Grad entspricht 100 Prozent. Wenn die Oberfläche senkrechter wird, verstärkt sich der prozentuale Anstieg.
Bei der planaren Methode ist der Z-Faktor für die korrekte Neigungsberechnung wichtig, wenn die (vertikalen) Z-Oberflächeneinheiten andere Maßeinheiten als die XY-Geländeeinheiten aufweisen. Der Parameter Z-Faktor wird nur dann aktualisiert, wenn die planare Methode ausgewählt ist.
Bei der geodätischen Methode stellt die Angabe der Oberflächen-Z-Einheit ein genaues Ergebnis sicher. Der Parameter Z-Einheit wird nur dann aktualisiert, wenn die geodätische Methode ausgewählt ist.
Enthält das vertikale Koordinatensystem des Eingabe-Rasters eine Z-Einheit, wird sie automatisch angewendet. Es wird empfohlen, eine Z-Einheit für das Eingabe-Raster zu definieren, wenn keine vorhanden ist. Mithilfe des Werkzeugs Projektion definieren können Sie eine Z-Einheit angeben. Sollte keine vorhanden sein, wird als Standardeinheit Meter verwendet.
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 die 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.
Dieses Werkzeug lässt sich mit GPU beschleunigen, d. h. wenn ein kompatibler Grafikprozessor (GPU) in Ihrem System verfügbar ist, lässt sich damit die Leistung des Werkzeugs verbessern. Verwenden Sie den Parameter Zielgerät für Analyse (analysis_target_device in Python), um zu steuern, ob das Werkzeug mit der GPU oder der CPU ausgeführt wird.
Weitere Details zu kompatiblen GPUs, zum Konfigurieren von und Arbeiten mit GPU-Geräten sowie Tipps zur Problembehandlung finden Sie unter GPU-Verarbeitung mit Spatial Analyst in der Hilfe zur Erweiterung Spatial Analyst.
Parameter
arcpy.ddd.Slope(in_raster, out_raster, {output_measurement}, {z_factor}, {method}, {z_unit}, {analysis_target_device})
Name | Erläuterung | Datentyp |
in_raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
out_raster | Das Ausgabe-Neigungs-Raster. Es weist den Typ "Gleitkomma" auf. | Raster Dataset |
output_measurement (optional) | Hiermit werden die Maßeinheiten (Grad oder Prozent) des Ausgabe-Neigungs-Rasters angegeben.
| String |
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 |
method (optional) | Gibt an, ob die Berechnung mit einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode erfolgen soll.
Die planare Methode eignet sich zum Berechnen lokaler Flächen in einer Projektion, bei der die korrekte Entfernung und Fläche beibehalten werden. Damit lassen sich Analysen von Flächen wie Städten, Landkreisen oder flächenmäßig kleineren Bundesstaaten durchführen. Die geodätische Methode liefert ein genaueres Ergebnis, allerdings fällt hierfür evtl. eine längere Verarbeitungszeit an. | String |
z_unit (optional) | Gibt die lineare Einheit an, die für vertikale Z-Werte verwendet werden soll. Sie wird durch ein vertikales Koordinatensystem definiert, sofern vorhanden. Falls kein vertikales Koordinatensystem vorhanden ist, müssen Sie die Z-Einheit mithilfe der Einheitenliste definieren, um eine korrekte geodätische Berechnung sicherzustellen. Die Standardeinstellung lautet Meter.
| String |
analysis_target_device (optional) |
Gibt das Gerät an, das für die Berechnung verwendet wird.
| String |
Codebeispiel
In diesem Beispiel werden die Neigungswerte im Eingabe-Oberflächen-Raster bestimmt.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ddd.Slope("elevation", "C:/output/outslope01", "DEGREE", 0.3043)
In diesem Beispiel werden die Neigungswerte im Eingabe-Oberflächen-Raster bestimmt.
# Name: Slope_3d_Ex_02.py
# Description: Identifies the rate of maximum change
# in z-value from each cell.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outRaster = "C:/output/outslope02"
outMeasurement = "DEGREE"
zFactor = ""
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Slope
arcpy.ddd.Slope(inRaster, outRaster, outMeasurement, zFactor, method, zUnit)
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst oder Spatial Analyst
- Standard: Erfordert 3D Analyst oder Spatial Analyst
- Advanced: Erfordert 3D Analyst oder Spatial Analyst