Sombreado (Spatial Analyst)

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.

Más información sobre cómo funciona Sombreado

Ilustración

OutRas = Hillshade(InRas1, 99, 33)

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

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	Ráster de entrada de superficie.	Raster Layer
Acimut (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
Altitud (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
Sombras modelo (Opcional)	Tipo de relieves sombreados que se generarán. Desactivada: el ráster de salida sólo considera los ángulos de iluminación local; no se consideran los efectos de las sombras. Los valores de salida pueden variar de 0 a 255, donde 0 representa las áreas más oscuras y 255 las más luminosas. Esta es la opción predeterminada. Activada: el ráster de salida sombreado considera tanto los ángulos de iluminación local como las sombras. Los valores de salida pueden variar de 0 a 255, donde 0 representa las áreas de sombra y 255 las más luminosas.	Boolean
Factor z (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

Etiqueta	Explicación	Tipo de datos
Ráster de salida	Ráster de sombreado de salida. El ráster de sombreado tiene un rango de valores enteros de 0 a 255.	Raster

Python

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

Nombre	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. NO_SHADOWS—El ráster de salida solo considera los ángulos de iluminación local; no se consideran los efectos de las sombras.Los valores de salida pueden variar de 0 a 255, donde 0 representa las áreas más oscuras y 255 las más luminosas. Esta es la opción predeterminada. SHADOWS—El ráster de salida sombreado considera tanto los ángulos de iluminación local como las sombras.Los valores de salida pueden variar de 0 a 255, donde 0 representa las áreas de sombra y 255 las más luminosas.	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

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

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

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

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

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