Schummerung (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Erstellt unter Berücksichtigung von Beleuchtungsquellwinkel und Schatten ein geschummertes Relief aus einem Oberflächen-Raster.

Weitere Informationen zur Funktionsweise des Werkzeugs "Schummerung"

Abbildung

OutRas = Hillshade(InRas1, 99, 33)

Verwendung

• Mit dem Werkzeug Schummerung können Sie ein Raster in ein geschummertes Relief-Raster konvertieren. Die Beleuchtungsquelle befindet sich dafür bei unendlich.

• Das Schummerungs-Raster besitzt einen ganzzahligen Wertebereich von 0 bis 255.

• Zwei Typen geschummerter Relief-Raster können ausgegeben werden. Bei deaktivierter (nicht markierter) Option Schatten modellieren berücksichtigt das Ausgabe-Raster nur den lokalen Beleuchtungswinkel. Bei aktivierter (markierter) Option berücksichtigt das Ausgabe-Raster die Auswirkungen sowohl des Beleuchtungswinkels als auch des Schattens.

• Die Analyse des Schattens erfolgt durch Berücksichtigen der Auswirkungen des lokalen Horizonts in jeder Zelle. Raster-Zellen im Schatten wird der Wert 0 zugewiesen.

• Um nur ein Raster der Schattenflächen zu erstellen, verwenden Sie das Werkzeug If-Else-Bedingungen, Reklassifizieren oder Nach Attributen extrahieren, und trennen Sie den Wert 0 von den übrigen Schummerungswerten. Die Option Schatten modellieren muss aktiviert sein, um dieses Ergebnis zu erstellen.

• Wenn sich das Eingabe-Raster in einem sphäroidischen Koordinatensystem (mit Dezimalgraden) befindet, kann die resultierende Schummerung eigentümlich aussehen. Dies liegt am Unterschied bei der Messung zwischen den horizontalen Oberflächeneinheiten und den Z-Höheneinheiten. Da die Länge eines Längengrades sich mit dem Breitengrad ändert, müssen Sie für diesen Breitengrad einen geeigneten Z-Faktor angeben. Wenn die XY-Einheiten in Dezimalgrad und die Z-Einheiten in Meter angegeben werden, können Sie zum Beispiel die folgenden Z-Faktoren für bestimmte Breitengrade verwenden:

      Latitude     Z-factor
       0           0.00000898
      10           0.00000912
      20           0.00000956
      30           0.00001036
      40           0.00001171
      50           0.00001395
      60           0.00001792
      70           0.00002619
      80           0.00005156

• 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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
Azimut (optional)	Azimutwinkel der Lichtquelle. Der Azimut wird im Uhrzeigersinn von Norden aus in Grad von 0 bis 360 gemessen. Die Standardeinstellung ist 315 Grad.	Double
Höhe (optional)	Höhenwinkel der Lichtquelle über dem Horizont. Die Höhe wird in positiven Graden ausgedrückt, mit 0 Grad am Horizont und 90 Grad direkt darüber. Die Standardeinstellung ist 45 Grad.	Double
Schatten modellieren (optional)	Der Typ des zu erstellenden geschummerten Reliefs. Nicht markiert: Das Ausgabe-Raster berücksichtigt nur lokale Beleuchtungswinkel. Die Auswirkungen der Schatten werden ignoriert. Die Ausgabewerte können von 0 bis 255 reichen, wobei 0 für die dunkelsten und 255 für die hellsten Flächen steht. Dies ist die Standardeinstellung. Markiert: Im ausgegebenen geschummerten Raster werden sowohl lokale Beleuchtungswinkel als auch Schatten berücksichtigt. Die Ausgabewerte können von 0 bis 255 reichen, wobei 0 für die Schattenbereiche und 255 für die hellsten Flächen steht.	Boolean
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

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Schummerungs-Raster. Das Schummerungs-Raster besitzt einen ganzzahligen Wertebereich von 0 bis 255.	Raster

Python

MISSING_TOOLNAME(in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})

Name	Erläuterung	Datentyp
in_raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
azimuth (optional)	Azimutwinkel der Lichtquelle. Der Azimut wird im Uhrzeigersinn von Norden aus in Grad von 0 bis 360 gemessen. Die Standardeinstellung ist 315 Grad.	Double
altitude (optional)	Höhenwinkel der Lichtquelle über dem Horizont. Die Höhe wird in positiven Graden ausgedrückt, mit 0 Grad am Horizont und 90 Grad direkt darüber. Die Standardeinstellung ist 45 Grad.	Double
model_shadows (optional)	Der Typ des zu erstellenden geschummerten Reliefs. NO_SHADOWS—Das Ausgabe-Raster berücksichtigt nur lokale Beleuchtungswinkel. Die Auswirkungen der Schatten werden ignoriert.Die Ausgabewerte können von 0 bis 255 reichen, wobei 0 für die dunkelsten und 255 für die hellsten Flächen steht. Dies ist die Standardeinstellung. SHADOWS—Im ausgegebenen geschummerten Raster werden sowohl lokale Beleuchtungswinkel als auch Schatten berücksichtigt.Die Ausgabewerte können von 0 bis 255 reichen, wobei 0 für die Schattenbereiche und 255 für die hellsten Flächen steht.	Boolean
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

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Schummerungs-Raster. Das Schummerungs-Raster besitzt einen ganzzahligen Wertebereich von 0 bis 255.	Raster

Codebeispiel

Hillshade: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Schummerungs-Raster generiert, das Schatten einschließt. Es werden bestimmte Azimut- und Höhenwinkel festgelegt.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outHillshade = Hillshade("elevation", 180, 75, "SHADOWS", 1)
outHillshade.save("C:/sapyexamples/output/outhillshd01")

Hillshade: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Schummerungs-Raster generiert, das Schatten einschließt. Es werden spezifische Dreh- und Höhenwinkel festgelegt, und für die Umwandlung der Z-Einheiten von Fuß in Meter wird ein Z-Faktor verwendet.

# Name: Hillshade_Ex_02.py
# Description: Computes hillshade values for a raster surface.
# 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"
azimuth = 180
altitude = 75
modelShadows = "SHADOWS"
zFactor = 0.348

# Execute HillShade
outHillShade = Hillshade(inRaster, azimuth, altitude, modelShadows, zFactor)

# Save the output 
outHillShade.save("C:/sapyexamples/output/outhillshd02")

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