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.
Ilustración
Uso
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, es importante especificar la unidad z de una superficie para garantizar 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 Sistema de coordenadas de salida no conforme. Estos ángulos se pueden utilizar para localizar con precisión puntos a lo largo de la pendiente descendente más pronunciada.
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 de 3 x 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 unidad de procesamiento de gráficos (GPU) al calcular la orientación geodésica. Significa que, si el sistema dispone de un dispositivo GPU, este se utilizará para mejorar el rendimiento del método geodésico.
Encontrará más información sobre cómo configurar su dispositivo de GPU en la ayuda de la extensión Spatial Analyst en el tema de ayuda Procesamiento de GPU con Spatial Analyst.
Sintaxis
arcpy.3d.Aspect(in_raster, out_raster, {method}, {z_unit}, {project_geodesic_azimuths})| Parámetro | Explicación | Tipo de datos |
in_raster | Ráster de entrada de superficie. | Raster Layer |
out_raster | Ráster de orientación de salida. Será de tipo punto flotante. | Raster Dataset |
method (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. | String |
z_unit (Opcional) | La unidad lineal de los valores z verticales. Se define mediante un sistema de coordenadas verticales si existe. Si no existe un sistema de coordenadas verticales, la unidad z debe definirse en una lista de unidades para garantizar el cómputo geodésico correcto. El valor predeterminado es 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.
| Boolean |
Muestra de código
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
env.workspace = "C:/data"
arcpy.Aspect_3d("elevation", "C:/output/outaspect.img")En este ejemplo se crea un ráster de orientación desde un ráster de superficie de entrada.
# Name: Aspect_3d_Ex_02.py
# Description: Derives aspect from a raster surface.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outAspect = "C:/output/outaspect2"
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Aspect
arcpy.Aspect_3d(inRaster, outAspect, method, zUnit)Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst oSpatial Analyst
- Standard: Requiere 3D Analyst oSpatial Analyst
- Advanced: Requiere 3D Analyst oSpatial Analyst