Schummerung (3D Analyst)

Zusammenfassung

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

Weitere Informationen zur Funktionsweise des Werkzeugs "Schummerung" Weitere Informationen zur Funktionsweise des Werkzeugs "Schummerung"

Abbildung

Abbildung "Schummerung"
OutRas = Hillshade(InRas1, 99, 33) HillShade_3d (InRas1, 99, 33, OutRas)

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.

    Um nur ein Raster der Schattenflächen zu erstellen, verwenden Sie das Werkzeug Reklassifizieren, 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 Geländeeinheiten 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

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Oberflächen-Raster.

Raster Layer
Ausgabe-Raster

Das Ausgabe-Schummerungs-Raster.

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

Raster Dataset
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

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Schummerungs-Raster.

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

Raster

arcpy.ddd.HillShade(in_raster, out_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})
NameErläuterungDatentyp
in_raster

Das Eingabe-Oberflächen-Raster.

Raster Layer
out_raster

Das Ausgabe-Schummerungs-Raster.

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

Raster Dataset
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_SHADOWSDas 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.
  • SHADOWSIm 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

NameErläuterungDatentyp
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")
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
env.workspace = "C:/data"
arcpy.HillShade_3d("elevation", "C:/output/outhillshd01", 180, 75, "SHADOWS", 1)
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_3d_Ex_02.py
# Description: Computes hillshade values for a raster surface.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
outRaster = "C:/output/outhillshd02"
azimuth = 180
altitude = 75
modelShadows = "SHADOWS"
zFactor = 0.348

# Execute HillShade
arcpy.ddd.HillShade(inRaster, outRaster, azimuth, altitude, 
                    modelShadows, zFactor)

Verwandte Themen