Disponible con una licencia de Spatial Analyst.
Resumen
Crea un relieve sombreado a partir de un ráster de superficie teniendo en cuenta el ángulo de la fuente de iluminación y las sombras.
Ilustración
Uso
La herramienta Sombreado crea un ráster de relieve sombreado a partir de un ráster. Se considera que la fuente de iluminación está en el infinito.
El ráster de sombreado tiene un rango de valores enteros de 0 a 255.
Es posible obtener como salida dos tipos de rásteres de relieve sombreado. Si la opción Modelar sombras está deshabilitada (desactivada), el ráster de salida solo considera el ángulo de iluminación local. Si está habilitada (activada), el ráster de salida considera los efectos del ángulo de iluminación local y la sombra.
El análisis de las sombras se lleva a cabo teniendo en cuenta los efectos del horizonte local en cada celda. A las celdas ráster que están en la sombra se les asigna un valor de cero.
Para crear un ráster de las áreas de sombra solamente, utilice la herramienta Evaluación condicional, Reclasificar o Extraer por consulta de atributos para separar el valor cero de los demás valores del sombreado. La herramienta Sombreado debe tener habilitada la opción Modelar sombras.
Si el ráster de entrada es un sistema de coordenadas esféricas, como el de grados decimales, el sombreado resultante puede verse de manera peculiar. Esto se debe a la diferencia en la medición entre las unidades de suelo horizontales y las unidades z de elevación. Dado que la longitud de un grado de longitud cambia con la latitud, necesitará especificar un factor z apropiado para esa latitud. Si las unidades x,y son grados decimales y las unidades z son metros, algunos factores z apropiados para las latitudes particulares son:
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.00005156Es posible crear vistas tridimensionales espectaculares de la superficie sombreada a través de la superposición del ráster de salida en ArcGIS ArcScene.
Cuando el ráster de entrada se deba remuestrear, se utilizará la técnica Bilineal. Un ejemplo en el que se debe remuestrear un ráster de entrada se produce cuando el sistema de coordenadas de salida, la extensión o el tamaño de celda es diferente del de entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
Hillshade (in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})| Parámetro | Explicación | Tipo de datos |
in_raster |
Ráster de entrada de superficie. | Raster Layer |
azimuth (Opcional) | Ángulo acimutal de la fuente de luz. El acimut se expresa en grados positivos de 0 a 360, medidos en sentido de las agujas del reloj desde el norte. El valor predeterminado es 315 grados. | Double |
altitude (Opcional) | Ángulo de altitud de la fuente de luz sobre el horizonte. La altitud se expresa en grados positivos, con 0 grados en el horizonte y 90 directamente encima. El valor predeterminado es 45 grados. | Double |
model_shadows (Opcional) | Tipo de relieves sombreados que se generarán.
| Boolean |
z_factor (Opcional) | Cantidad de unidades x,y de suelo en una unidad z de superficie. El factor z ajusta las unidades de medida para las unidades z cuando son diferentes de las unidades x, y de la superficie de entrada. Los valores z de la superficie de entrada se multiplican por el factor z al calcular la superficie de salida final. Si las unidades z y las unidades x,y están en las mismas unidades de medida, el factor z es 1. Esta es la opción predeterminada. Si las unidades z y las unidades x,y están en diferentes unidades de medida, el factor z se debe establecer en el factor adecuado o los resultados serán incorrectos. Por ejemplo, si las unidades z son pies y las unidades x, y son metros, debe utilizar un factor z de 0,3048 para convertir las unidades z de pies a metros (1 pie = 0,3048 metros). | Double |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | Ráster de sombreado de salida. El ráster de sombreado tiene un rango de valores enteros de 0 a 255. | Raster |
Ejemplo de código
Ejemplo 1 de Sombreado (ventana de Python)
En este ejemplo se genera un ráster de sombreado que incluye sombras. Los ángulos de acimut y de altitud específicos están establecidos.
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")
Ejemplo 2 de Sombreado (secuencia de comandos independiente)
En este ejemplo se genera un ráster de sombreado que incluye sombras. Se establecen ángulos de acimut y altitud específicos y un factor z para convertir las unidades z de pies a metros.
# 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")
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst o 3D Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst o 3D Analyst