| Etiqueta | Explicación | Tipo de datos |
Ráster de entrada | Ráster de entrada de superficie. | Raster Layer |
Ráster de salida | Ráster de pendiente de salida. Será de tipo punto flotante. | Raster Dataset |
Unidades de medición de salida (Opcional) | Determina las unidades de medida (grados o porcentajes) del ráster de pendiente de salida.
| String |
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 |
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.
| String |
Unidad Z (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 |
Disponible con una licencia de Spatial Analyst.
Disponible con una licencia de 3D Analyst.
Resumen
Identifica la pendiente (gradiente o inclinación) de cada celda de un ráster
La herramienta Parámetros de superficie proporciona una nueva implementación y funcionalidad mejorada.
Ilustración
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 Pendiente. La herramienta Pendiente 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 Pendiente 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 Pendiente 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.
El rango de valores de la salida depende del tipo de unidades de medida.
- El rango de valores de pendiente en grados es 0 a 90.
- Para la elevación en porcentaje, el rango es de 0 a esencialmente infinito. Una superficie plana es 0 por ciento, una superficie de 45 grados es 100 por ciento y, a medida que la superficie se vuelve más vertical, la elevación en porcentaje es cada vez mayor.
El uso de un factor z es esencial para corregir los cálculos de la pendiente cuando las unidades z de la superficie (vertical) se expresan en unidades diferentes de las unidades x,y de terreno. El parámetro Factor z solo estará habilitado cuando se seleccione el método planar.
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.
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 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 cuando se calcula la pendiente geodésica, lo que significa que, si en el sistema hay disponible un dispositivo de GPU (unidad de procesamiento de gráficos), 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.
Parámetros
arcpy.ddd.Slope(in_raster, out_raster, {output_measurement}, {z_factor}, {method}, {z_unit})| Nombre | Explicación | Tipo de datos |
in_raster | Ráster de entrada de superficie. | Raster Layer |
out_raster | Ráster de pendiente de salida. Será de tipo punto flotante. | Raster Dataset |
output_measurement (Opcional) | Determina las unidades de medida (grados o porcentajes) del ráster de pendiente de salida.
| String |
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 |
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 |
Muestra de código
En este ejemplo se determinan los valores de pendiente del ráster de superficie de entrada.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Slope_3d("elevation", "C:/output/outslope01", "DEGREE", 0.3043)En este ejemplo se determinan los valores de pendiente del ráster de superficie de entrada.
# Name: Slope_3d_Ex_02.py
# Description: Identifies the rate of maximum change
# in z-value from each cell.
# 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"
outRaster = "C:/output/outslope02"
outMeasurement = "DEGREE"
zFactor = ""
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Slope
arcpy.Slope_3d(inRaster, outRaster, outMeasurement, zFactor, method, zUnit)Entornos
Casos especiales
Información de licenciamiento
- Basic: Requiere 3D Analyst o Spatial Analyst
- Standard: Requiere 3D Analyst o Spatial Analyst
- Advanced: Requiere 3D Analyst o Spatial Analyst