Disponible con una licencia de Spatial Analyst.
Disponible con una licencia de 3D 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 opción Sombras de modelo debe estar activada para crear este resultado.
Si el ráster de entrada es un sistema de coordenadas esféricas, como el de grados decimales, el sombrado 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.00005156Cuando 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 que se aplican a 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) | El número de unidades x, y de suelo en una superficie de unidades z. 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 x,y y las unidades z 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 |
Muestra de código
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")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
# Execute HillShade
outHillShade = Hillshade(inRaster, azimuth, altitude, modelShadows, zFactor)
# Save the output
outHillShade.save("C:/sapyexamples/output/outhillshd02")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst o 3D Analyst
- Standard: Requiere Spatial Analyst o 3D Analyst
- Advanced: Requiere Spatial Analyst o 3D Analyst