| Beschriftung | Erläuterung | Datentyp |
Eingabe-Oberflächen-Raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
Ausgabe-Mulden-Polygone | Die Ausgabe-Feature-Class, die die identifizierten Mulden enthält. Jedes Mulden-Polygon ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über die Mulde. Dabei handelt es sich um folgende Felder:
| Feature Class |
Eingabe-Raster oder Feature-Straßen (optional) | Das optionale Raster- oder Feature-Dataset, das die Straßen definiert. Die Straßen können durch ein Integer- oder Gleitkomma-Raster oder ein Punkt-, Linien- oder Polygon-Feature definiert sein. | Raster Layer; Feature Layer |
Ausgabe-Verbindungspunkte (optional) | Die optionalen Ausgabe-Punkte, die den niedrigsten Höhenpunkt in einer Mulde und den entsprechenden flussabwärts gelegenen Verbindungspunkt definieren. Eine flussabwärts gelegene Verbindung ist definiert als die nächstgelegene Zelle, die eine geringere Höhe aufweist als die Zelle mit der niedrigsten Höhe innerhalb einer Mulde. Jeder Punkt ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über den Punkt. Dabei handelt es sich um folgende Felder:
| Feature Class |
Minimaltiefe (optional) | Die für eine Mulde zulässige Minimaltiefe. Mulden, deren Maximaltiefe unter diesem Wert liegt, werden in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist 0,05 Meter oder das Äquivalent in der angegebenen Z-Einheit. | Linear Unit |
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 |
Mindestfläche (optional) | Die für eine Mulde zulässige Minimalfläche. Die Fläche ist die Oberfläche der Oberseite der Mulde. Mulden, deren Fläche unter diesem Wert liegt, werden in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist die Gesamtfläche von drei Zellen oder das Äquivalent in quadratischen Karteneinheiten des Raumbezugs für den Parameterwert für Eingabe-Oberflächen-Raster. | Areal Unit |
Maximale Entfernung zur Verbindung (optional) | Die maximal zulässige Entfernung zwischen der Kante einer Mulde und dem flussabwärts gelegenen Verbindungspunkt. Eine flussabwärts gelegene Verbindung ist definiert als die nächstgelegene Zelle, die eine geringere Höhe aufweist als die Zelle mit der niedrigsten Höhe innerhalb der Mulde. Ist die Entfernung zu einer flussabwärts gelegenen Verbindung größer als dieser Wert, wird die Mulde in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist 30 Meter oder das Äquivalent in Karteneinheiten im Quadrat des Raumbezugs für den Parameterwert für Eingabe-Oberflächen-Raster. | Linear Unit |
Maximale Entfernung zu Straßen (optional) | Die maximal zulässige Entfernung zwischen der Kante einer Mulde und der nächstgelegenen Straße. Ist die Entfernung einer Mulde zu einer Straße größer als dieser Wert, wird sie in der endgültigen Ausgabe nicht berücksichtigt. Der Parameter ist nur verfügbar, wenn ein Wert für den Parameter Eingabe-Raster oder Feature-Straßen angegeben wurde. Der Standardwert ist 30 Meter oder das Äquivalent in Karteneinheiten im Quadrat des Raumbezugs für den Parameterwert für Eingabe-Oberflächen-Raster. | Linear Unit |
Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Verortet anhand von räumlichen Merkmalen Flächen, die topografisch niedriger liegen als das umgebende Terrain.
Weitere Informationen zur Funktionsweise von Mulden verorten
Verwendung
Der Parameterwert für Eingabe-Oberflächen-Raster (in_surface_raster in Python) kann ein digitales Höhenmodell (DEM) sein. Intern werden Mulden anhand der Differenz zwischen dem aufgefüllten und dem ursprünglichen DEM identifiziert.
Nur Mulden, die alle durch die optionalen Analyseparameter festgelegten Anforderungen erfüllen, sind im Parameterwert für Ausgabe-Mulden-Polygone (out_depressions_polygons in Python) enthalten.
Der Parameterwert für Ausgabe-Verbindungspunkte (out_connection_points in Python) beinhaltet den Punkt der niedrigsten Höhe innerhalb einer Mulde und den flussabwärts gelegenen Verbindungspunkt für alle Mulden, die im Parameterwert für Ausgabe-Mulden-Polygone enthalten sind.
Die Angabe des Parameterwerts für die Z-Einheit (z_unit in Python) gewährleistet die korrekte Berechnung der Muldentiefe).
Wenn das vertikale Koordinatensystem des Eingabe-Oberflächen-Rasters eine Z-Einheit enthält, 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. Wenn kein Wert angegeben wird, wird standardmäßig Meter verwendet.
Der Parameter Maximale Entfernung zur Verbindung (max_connection_distance in Python) betrachtet die flussabwärts gelegene Verbindung als die nächstgelegene Zelle, die eine geringere Höhe aufweist als die Zelle mit der niedrigsten Höhe innerhalb der Mulde. Wenn es mehrere Zellen gibt, die diese Kriterien erfüllen, wird die erste gefundene Zelle zurückgegeben.
Der Parameter Maximale Entfernung zu Straßen (max_road_distance in Python) kann nur verwendet werden, wenn der Parameter Eingabe-Raster oder Feature-Straßen (in_road_data in Python) angegeben wurde.
Die Karteneinheit des Raumbezugs des Parameterwertes für Eingabe-Oberflächen-Raster wird verwendet, um die Standardeinheiten für die Parameter Mindestfläche, Maximale Entfernung zu Verbindung und Maximale Entfernung zu Straßen zu füllen. Wenn die Einheit, die über den Parameterwert für Eingabe-Oberflächen-Raster identifiziert wird, nicht sowohl mit einer verfügbaren Flächeneinheit als auch mit einer linearen Einheit übereinstimmt, werden die Parameter standardmäßig auf Quadratmeter bzw. Meter gesetzt.
Dieses Werkzeug unterstützt die parallele Verarbeitung. Wenn Ihr Computer mit mehreren Prozessoren oder mit Prozessoren, die mehrere Kerne haben, ausgestattet ist, kann eine höhere Leistung erzielt werden, vor allem bei größeren Datasets. Weitere Informationen zu dieser Funktion sowie zu den Konfigurationsmöglichkeiten finden Sie im Hilfethema Parallele Verarbeitung mit Spatial Analyst.
Das Werkzeug verwendet standardmäßig bis zu 50 % der verfügbaren Kerne. Sie können die Anzahl der Kerne, die das Werkzeug verwendet, mit der Umgebung Faktor für parallele Verarbeitung ändern.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Parameter
LocateDepressions(in_surface_raster, out_depressions_polygons, {in_road_data}, {out_connection_points}, {min_depth}, {z_unit}, {min_area}, {max_connection_distance}, {max_road_distance})| Name | Erläuterung | Datentyp |
in_surface_raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
out_depressions_polygons | Die Ausgabe-Feature-Class, die die identifizierten Mulden enthält. Jedes Mulden-Polygon ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über die Mulde. Dabei handelt es sich um folgende Felder:
| Feature Class |
in_road_data (optional) | Das optionale Raster- oder Feature-Dataset, das die Straßen definiert. Die Straßen können durch ein Integer- oder Gleitkomma-Raster oder ein Punkt-, Linien- oder Polygon-Feature definiert sein. | Raster Layer; Feature Layer |
out_connection_points (optional) | Die optionalen Ausgabe-Punkte, die den niedrigsten Höhenpunkt in einer Mulde und den entsprechenden flussabwärts gelegenen Verbindungspunkt definieren. Eine flussabwärts gelegene Verbindung ist definiert als die nächstgelegene Zelle, die eine geringere Höhe aufweist als die Zelle mit der niedrigsten Höhe innerhalb einer Mulde. Jeder Punkt ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über den Punkt. Dabei handelt es sich um folgende Felder:
| Feature Class |
min_depth (optional) | Die für eine Mulde zulässige Minimaltiefe. Mulden, deren Maximaltiefe unter diesem Wert liegt, werden in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist 0,05 Meter oder das Äquivalent in der angegebenen Z-Einheit. | Linear Unit |
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 |
min_area (optional) | Die für eine Mulde zulässige Minimalfläche. Die Fläche ist die Oberfläche der Oberseite der Mulde. Mulden, deren Fläche unter diesem Wert liegt, werden in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist die Gesamtfläche von drei Zellen oder das Äquivalent in Karteneinheiten im Quadrat des Raumbezugs für den Parameterwert für in_surface_raster. | Areal Unit |
max_connection_distance (optional) | Die maximal zulässige Entfernung zwischen der Kante einer Mulde und dem flussabwärts gelegenen Verbindungspunkt. Eine flussabwärts gelegene Verbindung ist definiert als die nächstgelegene Zelle, die eine geringere Höhe aufweist als die Zelle mit der niedrigsten Höhe innerhalb der Mulde. Ist die Entfernung zu einer flussabwärts gelegenen Verbindung größer als dieser Wert, wird die Mulde in der endgültigen Ausgabe nicht berücksichtigt. Der Standardwert ist 30 Meter oder das Äquivalent in Karteneinheiten im Quadrat des Raumbezugs für den Parameterwert für in_surface_raster. | Linear Unit |
max_road_distance (optional) | Die maximal zulässige Entfernung zwischen der Kante einer Mulde und der nächstgelegenen Straße. Ist die Entfernung einer Mulde zu einer Straße größer als dieser Wert, wird sie in der endgültigen Ausgabe nicht berücksichtigt. Der Parameter ist nur verfügbar, wenn für den Parameter in_road_data ein Wert angegeben ist. Der Standardwert ist 30 Meter oder das Äquivalent in Karteneinheiten im Quadrat des Raumbezugs für den Parameterwert für in_surface_raster. | Linear Unit |
Codebeispiel
Dieses Beispiel veranschaulicht, wie Sie Locate Depressions verwenden können, um Mulden aus einem Eingabe-Oberflächen-Raster zu verorten, ohne dass dafür zuerst Senken gefüllt werden müssen.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
outDepressions = LocateDepressions("elevation", "outdepressions01.shp", "",
"outpoints01.shp", "", "", "", "", "")In diesem Beispiel werden Mulden aus einer Eingabeoberfläche ohne vorheriges Füllen der Senken und ohne echte Mulden verortet.
# Name: LocateDepressions_standalone.py
# Description: Locates depressions that meet the specified criteria.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"
# Execute the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
inZUnit, inMinArea, inMaxConnectionDist,
inMaxRoadDist)
# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst
- Standard: Erfordert Spatial Analyst
- Advanced: Erfordert Spatial Analyst