Mulden verorten (Spatial Analyst Tools)

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 für alle Mulden, die im Parameterwert für Ausgabe-Mulden-Polygone enthalten sind.

Außerdem wird der flussabwärts liegende Verbindungspunkt für jede Mulde einbezogen, sofern für den Parameter Maximale Entfernung zur Verbindung (max_connection_distance in Python) ein Wert angegeben wurde.
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 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 zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter "Analyseumgebungen und Spatial Analyst".

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: `AREA`—Die Fläche der Mulde in Quadratmetern. `VOLUME`—Das Volumen der Mulde in Kubikmetern. `DIST_CON`—Die Entfernung zum flussabwärts gelegenen Verbindungspunkt in Metern. Dieses Feld wird nur dann erstellt, wenn der Parameterwert Maximale Entfernung zur Verbindung angegeben ist. `DIST_ROAD`—Die Entfernung zur nächstgelegenen Straße in Metern. Dieses Feld wird nur erstellt, wenn ein Dataset für den optionalen Eingabeparameter "Straßendaten" angegeben wird.	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. Der flussabwärts gelegene Verbindungspunkt und die zugehörigen Felder sind nur dann enthalten, wenn ein Wert für den Parameter Maximale Entfernung zur Verbindung angegeben ist. Jeder Punkt ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über den Punkt. Dabei handelt es sich um folgende Felder: `DEP_ID`—Die Kennung der Mulde, mit der der Punkt verknüpft ist. `POINT_TYPE`—Gibt an, ob es sich bei dem Punkt um den niedrigsten Höhenpunkt in der Mulde (= 0) oder den flussabwärts gelegenen Verbindungspunkt (= 1) handelt. `POINT_ELEV`—Die Höhe des Punktes. `DIST_EDGE`—Die Entfernung zur Kante der Mulde in Metern. `DIST_POINT`—Die Entfernung zum entsprechenden Punkt in Metern.	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. Zoll—Die lineare Einheit ist Zoll. Fuß—Die lineare Einheit ist Fuß. Fuß (US Survey)—Die lineare Einheit ist Fuß (US Survey). Yard—Die lineare Einheit ist Yard. Meile (US Survey)—Die lineare Einheit ist Meile (US Survey). Seemeile—Die lineare Einheit ist Seemeilen. Millimeter—Die lineare Einheit ist Millimeter. Zentimeter—Die lineare Einheit ist Zentimeter. Meter—Die lineare Einheit ist Meter. Kilometer—Die lineare Einheit ist Kilometer. Dezimeter—Die lineare Einheit ist Dezimeter.	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. Dieser Parameter gilt nur dann, wenn für ihn ein Wert angegeben ist.	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

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: `AREA`—Die Fläche der Mulde in Quadratmetern. `VOLUME`—Das Volumen der Mulde in Kubikmetern. `DIST_CON`—Die Entfernung zum flussabwärts gelegenen Verbindungspunkt in Metern. Dieses Feld wird nur dann erstellt, wenn der Parameterwert `max_connection_distance` angegeben ist. `DIST_ROAD`—Die Entfernung zur nächstgelegenen Straße in Metern. Dieses Feld wird nur erstellt, wenn ein Dataset für den optionalen Eingabeparameter "Straßendaten" angegeben wird.	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. Der flussabwärts gelegene Verbindungspunkt und die zugehörigen Felder sind nur dann enthalten, wenn ein Wert für den Parameter `max_connection_distance` angegeben ist. Jeder Punkt ist eindeutig nummeriert. Zusätzliche Felder in der Attributtabelle speichern spezifische Informationen über den Punkt. Dabei handelt es sich um folgende Felder: `DEP_ID`—Die Kennung der Mulde, mit der der Punkt verknüpft ist. `POINT_TYPE`—Gibt an, ob es sich bei dem Punkt um den niedrigsten Höhenpunkt in der Mulde (= 0) oder den flussabwärts gelegenen Verbindungspunkt (= 1) handelt. `POINT_ELEV`—Die Höhe des Punktes. `DIST_EDGE`—Die Entfernung zur Kante der Mulde in Metern. `DIST_POINT`—Die Entfernung zum entsprechenden Punkt in Metern.	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. `INCH`—Die lineare Einheit ist Zoll. `FOOT`—Die lineare Einheit ist Fuß. `FOOT_US`—Die lineare Einheit ist Fuß (US Survey). `YARD`—Die lineare Einheit ist Yard. `MILE_US`—Die lineare Einheit ist Meile (US Survey). `NAUTICAL_MILE`—Die lineare Einheit ist Seemeilen. `MILLIMETER`—Die lineare Einheit ist Millimeter. `CENTIMETER`—Die lineare Einheit ist Zentimeter. `METER`—Die lineare Einheit ist Meter. `KILOMETER`—Die lineare Einheit ist Kilometer. `DECIMETER`—Die lineare Einheit ist Dezimeter.	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. Dieser Parameter gilt nur dann, wenn für ihn ein Wert angegeben ist.	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

LocateDepressions Beispiel 1 (Python-Fenster)

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", "", "", "", "", "")

LocateDepressions Beispiel 2 (eigenständiges Skript)

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"

# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"

# Run the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
                                    inZUnit, inMinArea, inMaxConnectionDist,
                                    inMaxRoadDist)

# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Aktueller Workspace, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Ausdehnung, Faktor für parallele Verarbeitung, Scratch-Workspace, Fang-Raster

Lizenzierungsinformationen