Disponible con una licencia de Spatial Analyst.
Resumen
Identifica la pendiente (gradiente o tasa de cambio máximo en el valor z) desde cada celda de una superficie de ráster.
Ilustración
Uso
Pendiente es la tasa de cambio máximo en el valor z desde cada celda.
El uso de un factor z es esencial para corregir los cálculos de la pendiente cuando las unidades z de la superficie se expresan en unidades diferentes de las unidades x,y de terreno.
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 0 hasta la aproximación al 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 se vuelve cada vez mayor. Consulte cómo funciona Pendiente para obtener una explicación más detallada del rango de valores de salida de esta opción.
Si la celda central en la vecindad inmediata (ventana de 3 x 3) es NoData, la salida es NoData.
Si las celdas vecinas son NoData, se les asigna el valor de la celda central; entonces se computa la pendiente.
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 válidos para esta herramienta.
Sintaxis
Slope (in_raster, {output_measurement}, {z_factor})
Parámetro | Explicación | Tipo de datos |
in_raster | Ráster de entrada de superficie. | Raster Layer |
output_measurement (Opcional) | Determina las unidades de medida (grados o porcentajes) del ráster de pendiente de salida.
| String |
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
Nombre | Explicación | Tipo de datos |
out_raster | Ráster de pendiente de salida. Será de tipo punto flotante. | Raster |
Muestra de código
Ejemplo 1 de Pendiente (ventana de Python)
En este ejemplo se determinan los valores de pendiente del ráster de superficie de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSlope = Slope("elevation", "DEGREE", 0.3043)
outSlope.save("C:/sapyexamples/output/outslope01")
Ejemplo 2 de Pendiente (secuencia de comandos independiente)
En este ejemplo se determinan los valores de pendiente del ráster de superficie de entrada.
# Name: _Ex_02.py
# Description: Identifies the rate of maximum change
# in z-value from each cell.
# 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"
outMeasurement = "DEGREE"
zFactor = 0.3043
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Slope
outSlope = Slope(inRaster, outMeasurement, zFactor)
# Save the output
outSlope.save("C:/sapyexamples/output/outslope02")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Análisis espacial o 3D Analyst
- ArcGIS Desktop Standard: Requiere Análisis espacial o 3D Analyst
- ArcGIS Desktop Advanced: Requiere Análisis espacial o 3D Analyst