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 el Sombreado

Ilustración

Ilustración de Sombreado
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 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.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 que se aplican a esta herramienta.

Sintaxis

Hillshade(in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})
ParámetroExplicaciónTipo 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_SHADOWSEl 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.
  • SHADOWSEl 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)

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

NombreExplicaciónTipo 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 (script 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")

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

Temas relacionados