Top-Hat-Transformation (Spatial Analyst Tools)

Zusammenfassung

Erkennt durch Berechnung der Top-Hat-Transformationen räumliche Strukturen auf einer Raster-Oberfläche.

Weitere Informationen zur Funktionsweise von "Top-Hat-Transformation"

Verwendung

Das Ausgabe-Raster stellt die Höhe oder Tiefe der an jeder Zellenposition erkannten räumlichen Strukturen dar.
Der Wert des Parameters Analysetyp gibt den Typ der räumlichen Strukturen an, die erkannt werden sollen. Die zwei Optionen sind Erhöhung und Senkung. Der Analysetyp Erhöhung erkennt räumliche Strukturen, die höher sind als ihre Umgebung. Der Analysetyp Senkung erkennt räumliche Strukturen, die niedriger sind als ihre Umgebung.
Der Wert des Parameters Nachbarschaft bestimmt die Form und Größe des für die Analyse verwendeten Fensters. Räumliche Strukturen, deren Größe oder Breite kleiner als diese Nachbarschaft ist, werden im Allgemeinen erkannt.
Die verfügbaren Nachbarschaftsformen sind: Kreis, Rechteck und Unregelmäßig. Die Option der unregelmäßigen Nachbarschaft ist eine benutzerdefinierte Nachbarschaft, die mithilfe einer Kernel-Datei definiert wird.

Die Kernel-Datei ist eine ASCII-Textdatei, die die Werte und die Form einer Nachbarschaft angibt. Die Datei kann mit einem beliebigen Texteditor erstellt werden. Die Datei muss die Erweiterung .txt aufweisen, und im Dateinamen dürfen keine Leerzeichen enthalten sein.
Wenn das Ausgabe-Raster-Format .crf lautet, wird in diesem Werkzeug die Raster-Speicherumgebung Pyramide unterstützt. In der Ausgabe werden standardmäßig Pyramiden erstellt. Bei anderen Ausgabeformaten wird diese Umgebung nicht unterstützt, und es werden keine Pyramiden erstellt.
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
Nachbarschaft (Optional)	Die Zellen um eine Verarbeitungszelle, die bei der Berechnung der Top-Hat-Transformation verwendet werden sollen. Es stehen verschiedene vordefinierte Nachbarschaftstypen zur Auswahl. Alternativ kann ein benutzerdefinierter Kernel definiert werden. Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standard-Nachbarschaft ist ein Kreis mit einem Radius von 3 Zellen. Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben: Kreis, Radius, Einheitentyp Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen. Rechteck, Höhe, Breite, Einheitentyp Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Der Minimalwert für Breite oder Höhe beträgt 1 Zelle und der Maximalwert 4096 Zellen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen. Unregelmäßig, Kernel-Datei Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden. Der Minimalwert für Breite oder Höhe des Kernels beträgt 1 Zelle und der Maximalwert 4096 Zellen. Für die Nachbarschaftstypen "Kreis" und "Rechteck" können die Entfernungseinheiten der Parameter als Einheiten der Zelle oder der Karte angegeben werden. Die Standardeinstellung sind Zelleneinheiten. Bei unregelmäßigen Nachbarschaftstypen definiert die erste Zelle in der Kernel-Datei die Breite und Höhe der Nachbarschaft als Anzahl von Zellen. In den darauffolgenden Zeilen ist angegeben, wie der Eingabewert verarbeitet wird, der der jeweiligen Position im Kernel entspricht. Ein Wert von 0 in der Kernel-Datei bedeutet, dass die entsprechende Position nicht in die Berechnung einbezogen wird. Ein Wert von 1 bedeutet, dass die entsprechende Eingabezelle einbezogen wird.	Neighborhood
Analysetyp (Optional)	Gibt den Typ der Objekte an, die erkannt werden sollen. Erhöhung—Es werden Objekte erkannt, die höher als ihre Umgebung sind (z. B. Brücken, Dämme und Gebirgskämme). Dies ist die Standardeinstellung. Senkung—Es werden Objekte erkannt, die niedriger als ihre Umgebung sind (z. B. Wasserkanäle und Täler).	String

Beschriftung

Erläuterung

Datentyp

Eingabe-Oberflächen-Raster

Das Eingabe-Oberflächen-Raster.

Raster Layer

Nachbarschaft

(Optional)

Die Zellen um eine Verarbeitungszelle, die bei der Berechnung der Top-Hat-Transformation verwendet werden sollen. Es stehen verschiedene vordefinierte Nachbarschaftstypen zur Auswahl. Alternativ kann ein benutzerdefinierter Kernel definiert werden.

Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standard-Nachbarschaft ist ein Kreis mit einem Radius von 3 Zellen.

Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben:

Kreis, Radius, Einheitentyp

Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen.
Rechteck, Höhe, Breite, Einheitentyp

Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Der Minimalwert für Breite oder Höhe beträgt 1 Zelle und der Maximalwert 4096 Zellen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen.
Unregelmäßig, Kernel-Datei

Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden. Der Minimalwert für Breite oder Höhe des Kernels beträgt 1 Zelle und der Maximalwert 4096 Zellen.

Für die Nachbarschaftstypen "Kreis" und "Rechteck" können die Entfernungseinheiten der Parameter als Einheiten der Zelle oder der Karte angegeben werden. Die Standardeinstellung sind Zelleneinheiten.

Bei unregelmäßigen Nachbarschaftstypen definiert die erste Zelle in der Kernel-Datei die Breite und Höhe der Nachbarschaft als Anzahl von Zellen. In den darauffolgenden Zeilen ist angegeben, wie der Eingabewert verarbeitet wird, der der jeweiligen Position im Kernel entspricht. Ein Wert von 0 in der Kernel-Datei bedeutet, dass die entsprechende Position nicht in die Berechnung einbezogen wird. Ein Wert von 1 bedeutet, dass die entsprechende Eingabezelle einbezogen wird.

Neighborhood

Analysetyp

(Optional)

Gibt den Typ der Objekte an, die erkannt werden sollen.

Erhöhung—Es werden Objekte erkannt, die höher als ihre Umgebung sind (z. B. Brücken, Dämme und Gebirgskämme). Dies ist die Standardeinstellung.
Senkung—Es werden Objekte erkannt, die niedriger als ihre Umgebung sind (z. B. Wasserkanäle und Täler).

String

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster. Je nach Analysetyp entsprechen die Zellenwerte des Ausgabe-Rasters der Höhe oder Tiefe der an einer Zellenposition erkannten Objekte. Wenn die Option Erhöhung für den Parameter Analysetyp festgelegt ist, dann entsprechen die Ausgabewerte der Höhe der an einer Zellenposition erkannten Objekte. Wenn die Option Senkung für den Parameter Analysetyp festgelegt ist, dann entsprechen die Ausgabewerte der Tiefe der an einer Zellenposition erkannten Objekte.	Raster

Beschriftung

Erläuterung

Datentyp

Ausgabe-Raster

Das Ausgabe-Raster.

Je nach Analysetyp entsprechen die Zellenwerte des Ausgabe-Rasters der Höhe oder Tiefe der an einer Zellenposition erkannten Objekte. Wenn die Option Erhöhung für den Parameter Analysetyp festgelegt ist, dann entsprechen die Ausgabewerte der Höhe der an einer Zellenposition erkannten Objekte. Wenn die Option Senkung für den Parameter Analysetyp festgelegt ist, dann entsprechen die Ausgabewerte der Tiefe der an einer Zellenposition erkannten Objekte.

Raster

TopHatTransform(in_raster, {neighborhood}, {analysis_type})

Name Erläuterung Datentyp

Name	Erläuterung	Datentyp
in_raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
neighborhood (Optional)	Die Zellen um eine Verarbeitungszelle, die bei der Berechnung der Top-Hat-Transformation verwendet werden sollen. Es stehen verschiedene vordefinierte Nachbarschaftstypen zur Auswahl. Alternativ kann ein benutzerdefinierter Kernel definiert werden. Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standard-Nachbarschaft ist ein Kreis mit einem Radius von 3 Zellen. Die Form der Nachbarschaften bestimmt sich aus der Klasse `Neighborhood`. Die verfügbaren Nachbarschaftstypen sind `NbrCircle`, `NbrRectangle` und `NbrIrregular`. Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben: `NbrCircle({radius}, {units}` Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen. `NbrRectangle({width}, {height}, {units})` Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Der Minimalwert für Breite oder Höhe beträgt 1 Zelle und der Maximalwert 4096 Zellen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen. `NbrIrregular(inKernelFile)` Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden. Der Minimalwert für Breite oder Höhe des Kernels beträgt 1 Zelle und der Maximalwert 4096 Zellen. Bei unregelmäßigen Nachbarschaftstypen definiert die erste Zelle in der Kernel-Datei die Breite und Höhe der Nachbarschaft als Anzahl von Zellen. In den darauffolgenden Zeilen ist angegeben, wie der Eingabewert verarbeitet wird, der der jeweiligen Position im Kernel entspricht. Ein Wert von 0 in der Kernel-Datei bedeutet, dass die entsprechende Position nicht in die Berechnung einbezogen wird. Ein Wert von 1 bedeutet, dass die entsprechende Eingabezelle einbezogen wird.	Neighborhood
analysis_type (Optional)	Gibt den Typ der Objekte an, die erkannt werden sollen. `RIDGE`—Es werden Objekte erkannt, die höher als ihre Umgebung sind (z. B. Brücken, Dämme und Gebirgskämme). Dies ist die Standardeinstellung. `VALLEY`—Es werden Objekte erkannt, die niedriger als ihre Umgebung sind (z. B. Wasserkanäle und Täler).	String

in_raster

Das Eingabe-Oberflächen-Raster.

Raster Layer

neighborhood

(Optional)

Die Form der Nachbarschaften bestimmt sich aus der Klasse Neighborhood. Die verfügbaren Nachbarschaftstypen sind NbrCircle, NbrRectangle und NbrIrregular.

Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben:

NbrCircle({radius}, {units}

Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen.
NbrRectangle({width}, {height}, {units})

Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Der Minimalwert für Breite oder Höhe beträgt 1 Zelle und der Maximalwert 4096 Zellen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen.
NbrIrregular(inKernelFile)

Eine benutzerdefinierte Nachbarschaft, deren Spezifikationen durch die angegebene Kernel-Textdatei festgelegt werden. Der Minimalwert für Breite oder Höhe des Kernels beträgt 1 Zelle und der Maximalwert 4096 Zellen.

Neighborhood

analysis_type

(Optional)

Gibt den Typ der Objekte an, die erkannt werden sollen.

RIDGE—Es werden Objekte erkannt, die höher als ihre Umgebung sind (z. B. Brücken, Dämme und Gebirgskämme). Dies ist die Standardeinstellung.
VALLEY—Es werden Objekte erkannt, die niedriger als ihre Umgebung sind (z. B. Wasserkanäle und Täler).

String

Rückgabewert

Name Erläuterung Datentyp

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster. Je nach Analysetyp entsprechen die Zellenwerte des Ausgabe-Rasters der Höhe oder Tiefe der an einer Zellenposition erkannten Objekte. Wenn die Option `RIDGE` für den Parameter `analysis_type` festgelegt ist, dann entsprechen die Ausgabewerte der Höhe der an einer Zellenposition erkannten Objekte. Wenn die Option `VALLEY` für den Parameter `analysis_type` festgelegt ist, dann entsprechen die Ausgabewerte der Tiefe der an einer Zellenposition erkannten Objekte.	Raster

out_raster

Das Ausgabe-Raster.

Je nach Analysetyp entsprechen die Zellenwerte des Ausgabe-Rasters der Höhe oder Tiefe der an einer Zellenposition erkannten Objekte. Wenn die Option RIDGE für den Parameter analysis_type festgelegt ist, dann entsprechen die Ausgabewerte der Höhe der an einer Zellenposition erkannten Objekte. Wenn die Option VALLEY für den Parameter analysis_type festgelegt ist, dann entsprechen die Ausgabewerte der Tiefe der an einer Zellenposition erkannten Objekte.

Raster

Codebeispiel

TopHatTransform Beispiel 1 (Python-Fenster)

Dieses Beispiel berechnet die Top-Hat-Transformation für ein Eingabe-Raster mit dem Analysetyp "Senkung".

from arcpy.sa import *
outRas = TopHatTransform('elevation.tif', "Circle 3 CELL", 'VALLEY')
outRas.save("C:/sapyexamples/output/thtout01.tif")

TopHatTransform Beispiel 2 (eigenständiges Skript)

Dieses Beispiel berechnet die Top-Hat-Transformation für ein Eingabe-Raster mit dem Analysetyp "Erhöhung".

# Name: TopHatTransform_standalone.py
# Description: Calculates the top hat transform.
# 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"
inNeighborhood = "Circle 90 Map"
inAnalysisType = "RIDGE"

# Run the tool
outRas = TopHatTransform(inRaster, inNeighborhood, inAnalysisType)

# Save the output
outRas.save("C:/sapyexamples/output/thtout02.tif")

Umgebungen

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

Lizenzierungsinformationen

Basic: Erfordert Spatial Analyst
Standard: Erfordert Spatial Analyst
Advanced: Erfordert Spatial Analyst

Top-Hat-Transformation (Spatial Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Rückgabewert

Umgebungen

Lizenzierungsinformationen

Verwandte Themen