Orientación (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con una licencia de 3D Analyst.

Resumen

Calcula la orientación de cada celda a partir de una superficie ráster.

La orientación identifica la dirección de brújula a la que apunta la pendiente descendente en cada ubicación.

La herramienta Parámetros de superficie proporciona una nueva implementación y funcionalidad mejorada.

Más información sobre cómo funciona la Orientación

Ilustración

Ilustración de la herramienta Orientación
OutRas = Aspect(InRas1)

Uso

  • La herramienta Parámetros de superficie proporciona una implementación de orientación más reciente y se recomienda su uso en lugar de la herramienta Orientación. La herramienta Orientación ajusta un plano a las nueve celdas locales, pero un plano puede no ser un buen descriptor del paisaje y puede enmascarar o exagerar variaciones de interés naturales. La herramienta Parámetros de superficie ajusta una superficie a la vecindad de celdas, en lugar de un plano, lo que proporciona un ajuste más natural al terreno.

    La herramienta Orientación utiliza una ventana de celdas de 3 por 3 para calcular el valor, mientras que la herramienta Parámetros de superficie permite tamaños de ventana de 3 por 3 a 15 por 15 celdas. Los tamaños de ventana más grandes son útiles con datos de elevación de alta resolución para capturar procesos de superficie de suelo a una escala adecuada. Parámetros de superficie también proporciona una opción de ventana adaptable, que evalúa la variabilidad local del terreno e identifica el mayor tamaño de vecindad adecuado para cada celda. Puede resultar útil con terreno homogéneo gradual interrumpido por arroyos, carreteras o cortes agudos de pendiente.

    Puede seguir utilizando el enfoque tradicional de la herramienta Orientación si necesita que los resultados coincidan exactamente con las ejecuciones anteriores de la herramienta o si es más importante un tiempo de ejecución más corto que un algoritmo mejor.

  • Esta herramienta utiliza una ventana móvil de celda de 3 por 3 para procesar los datos. Si la celda de procesamiento es NoData, la salida para esa ubicación será NoData.

  • Esta herramienta requiere que, de las ocho celdas vecinas a la celda de procesamiento, al menos siete de ellas tengan un valor válido. Si hay menos de siete celdas válidas, el cálculo no se realizará y la salida en esa celda de procesamiento será NoData.

  • Las celdas de las filas y columnas más exteriores del ráster de salida serán NoData. Esto se debe a que esas celdas no tienen suficientes vecinos válidos a lo largo del límite del dataset de entrada.

  • La orientación se expresa en grados positivos de 0 a 360, medidos en el sentido de las agujas del reloj desde el norte.

  • A las celdas del ráster de entrada que son planas, sin pendiente, se les asigna una orientación de -1.

  • En el método geodésico, especificar la unidad z de una superficie garantiza la precisión de la salida. El parámetro Unidad z solo estará habilitado cuando se seleccione el método geodésico.

  • Si hay una unidad z disponible en el sistema de coordenadas verticales del ráster de entrada, se aplicará automáticamente. Se recomienda definir una unidad z para el ráster de entrada si falta esta unidad. Puede usar la herramienta Definir proyección para especificar una unidad z. Si no se ha definido, se utilizará el metro de manera predeterminada.

  • El parámetro Acimuts geodésicos del proyecto (project_geodesic_azimuths en Python) solo está disponible si el parámetro Método tiene el valor Geodésico.

    En el caso del método Geodésico, si el parámetro Acimuts geodésicos del proyecto está activado (project_geodesic_azimuths tiene el valor PROJECT_GEODESIC_AZIMUTHS en Python), se cumple lo siguiente:

    • El norte siempre se representa mediante 360 grados.
    • Se proyectan acimuts para corregir la distorsión causada por un valor no conforme del entorno Sistema de coordenadas de salida. Estos ángulos se pueden utilizar para localizar con precisión puntos a lo largo de la pendiente descendente más pronunciada.

    Active el parámetro Acimuts geodésicos del proyecto si desea usar la salida de Aspecto como entrada de dirección hacia atrás de la herramienta en el conjunto de herramientas Distancia.

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

  • Si el valor del parámetro Ráster de entrada (in_raster en Python) es de alta resolución con un tamaño de celda inferior a unos pocos metros o especialmente ruidoso, plantéese usar la herramienta Parámetros de superficie y su opción de distancia de vecindad definida por el usuario en lugar de la vecindad 3 por 3 inmediata de esta herramienta. Utilizar una vecindad más grande puede minimizar el efecto de las superficies ruidosas. Utilizar una vecindad más grande también puede representar mejor formas de suelo y características de superficie cuando se utilizan superficies de alta resolución.

  • Esta herramienta se puede agilizar mediante una GPU, lo que significa que si en el sistema hay disponible una unidad de procesamiento de gráficos (GPU), se utilizará para mejorar el rendimiento de la herramienta. Utilice el parámetro Dispositivo objetivo para el análisis (analysis_target_device en Python) para controlar si la GPU o la CPU se utilizarán para ejecutar la herramienta.

    Consulte Procesamiento de GPU con Spatial Analyst para obtener más información sobre GPU compatibles, configurar y trabajar con dispositivos GPU, así como sugerencias de solución de problemas.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

Ráster de entrada de superficie.

Raster Layer
Método
(Opcional)

Especifica si el cálculo se basará en un método planar (Tierra plana) o geodésico (elipsoide).

El método planar es adecuado para utilizarlo en áreas locales en una proyección que mantiene la distancia y el área correctas. Es adecuado para análisis que cubren áreas como ciudades, condados o estados con áreas más pequeñas. El método geodésico produce un resultado más exacto, con el posible coste de un incremento del tiempo de procesamiento.

  • PlanarEl cálculo se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Este es el método predeterminado.
  • GeodésicaEl cálculo se realizará en un sistema de coordenadas cartesianas 3D teniendo en cuenta la forma de la Tierra como un elipsoide.
String
Unidad Z
(Opcional)

Especifica la unidad lineal que se utilizará para los valores z verticales.

Se define mediante un sistema de coordenadas verticales si existe. Si no existe ningún sistema de coordenadas verticales, defina la unidad z mediante la lista de unidades para garantizar el cómputo geodésico correcto. El valor predeterminado es metros.

  • PulgadaLa unidad lineal será pulgadas.
  • PieLa unidad lineal será pies.
  • YardaLa unidad lineal será yardas.
  • Milla (EE. UU.)La unidad lineal será millas.
  • Milla náuticaLa unidad lineal será millas náuticas.
  • MilímetroLa unidad lineal será milímetros.
  • CentímetroLa unidad lineal será centímetros.
  • ContadorLa unidad lineal será metros.
  • KilómetroLa unidad lineal será kilómetros.
  • DecímetroLa unidad lineal será decímetros.
String
Acimuts geodésicos del proyecto
(Opcional)

Especifica si se proyectan acimuts geodésicos para corregir la distorsión de ángulo causada por la referencia espacial de salida.

  • Desactivado: no se proyectan acimuts geodésicos. Esta es la opción predeterminada.
  • Activado: se proyectan acimuts geodésicos. Esta opción solo admite el procesamiento de CPU.
Boolean
Dispositivo objetivo para el análisis
(Opcional)

Especifica el dispositivo que se utilizará para realizar el cálculo.

  • GPU, luego, CPUSi se encuentra una GPU compatible, se utilizará para realizar el cálculo. De lo contrario, se utilizará la CPU. Esta es la opción predeterminada.
  • Solo CPUEl cálculo solo se realizará en la CPU.
  • Solo GPUEl cálculo solo se realizará en la GPU.
String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de orientación de salida.

Será de tipo punto flotante.

Raster

Aspect(in_raster, {method}, {z_unit}, {project_geodesic_azimuths}, {analysis_target_device})
NombreExplicaciónTipo de datos
in_raster

Ráster de entrada de superficie.

Raster Layer
method
(Opcional)

Especifica si el cálculo se basará en un método planar (Tierra plana) o geodésico (elipsoide).

  • PLANAREl cálculo se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Este es el método predeterminado.
  • GEODESICEl cálculo se realizará en un sistema de coordenadas cartesianas 3D teniendo en cuenta la forma de la Tierra como un elipsoide.

El método planar es adecuado para utilizarlo en áreas locales en una proyección que mantiene la distancia y el área correctas. Es adecuado para análisis que cubren áreas como ciudades, condados o estados con áreas más pequeñas. El método geodésico produce un resultado más exacto, con el posible coste de un incremento del tiempo de procesamiento.

String
z_unit
(Opcional)

Especifica la unidad lineal que se utilizará para los valores z verticales.

Se define mediante un sistema de coordenadas verticales si existe. Si no existe ningún sistema de coordenadas verticales, defina la unidad z mediante la lista de unidades para garantizar el cómputo geodésico correcto. El valor predeterminado es metros.

  • INCHLa unidad lineal será pulgadas.
  • FOOTLa unidad lineal será pies.
  • YARDLa unidad lineal será yardas.
  • MILE_USLa unidad lineal será millas.
  • NAUTICAL_MILELa unidad lineal será millas náuticas.
  • MILLIMETERLa unidad lineal será milímetros.
  • CENTIMETERLa unidad lineal será centímetros.
  • METERLa unidad lineal será metros.
  • KILOMETERLa unidad lineal será kilómetros.
  • DECIMETERLa unidad lineal será decímetros.
String
project_geodesic_azimuths
(Opcional)

Especifica si se proyectan acimuts geodésicos para corregir la distorsión de ángulo causada por la referencia espacial de salida.

  • GEODESIC_AZIMUTHSNo se proyectan acimuts geodésicos. Esta es la opción predeterminada.
  • PROJECT_GEODESIC_AZIMUTHSSe proyectan acimuts geodésicos.
Boolean
analysis_target_device
(Opcional)

Especifica el dispositivo que se utilizará para realizar el cálculo.

  • GPU_THEN_CPUSi se encuentra una GPU compatible, se utilizará para realizar el cálculo. De lo contrario, se utilizará la CPU. Esta es la opción predeterminada.
  • CPU_ONLYEl cálculo solo se realizará en la CPU.
  • GPU_ONLYEl cálculo solo se realizará en la GPU.
String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

Ráster de orientación de salida.

Será de tipo punto flotante.

Raster

Muestra de código

Ejemplo 1 de Orientación (ventana de Python)

En este ejemplo se crea un ráster de orientación desde un ráster de superficie de entrada.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAspect = Aspect("elevation")
outAspect.save("C:/sapyexamples/output/outaspect01.img")
Ejemplo 2 de Orientación (script independiente)

En este ejemplo se crea un ráster de orientación desde un ráster de superficie de entrada.

# Name: Aspect_Ex_02.py
# Description: Derives aspect from 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"
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Aspect
outAspect = Aspect(inRaster, method, zUnit)

# Save the output 
outAspect.save("C:/sapyexamples/output/outaspect02")

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