Sombreado (Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

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

Hillshade illustration
OutRas = Hillshade(InRas1, 99, 33)

Uso

Sintaxis

Hillshade (in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})
ParámetroExplicaciónTipo de datos
in_raster

Gá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.
  • 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)

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

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

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. Los ángulos acimut y de altitud específicos están establecidos, 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

Temas relacionados

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
9/11/2013