Schummerung (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

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

Weitere Informationen zur Funktionsweise des Werkzeugs "Schummerung"

Bild

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

Verwendung

Syntax

Hillshade (in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})
ParameterErläuterungDatentyp
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_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.
  • 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)

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. Hierbei handelt es sich um 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 Ganzzahl-Wertebereich von 0 bis 255.

Raster

Codebeispiel

Schummerung – 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")
Schummerung – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Schummerungs-Raster generiert, das Schatten einschließt. Es werden bestimmte Azimut- und Höhenwinkel festgelegt. Außerdem wird ein Z-Faktor bestimmt, mit dem Z-Einheiten, die in Fuß angegeben sind, in Meter umgerechnet werden.

# 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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst oder 3D Analyst
9/12/2013