Disponible con una licencia de Spatial Analyst.
Disponible con una licencia de 3D Analyst.
Resumen
Calcula la curvatura de una superficie de ráster e incluye, opcionalmente, la curvatura del perfil y del plano.
Uso
La salida principal es la curvatura de la superficie celda por celda, ajustada a través de esa celda y sus vecinos circundantes. La curvatura es la derivada segunda de la superficie, o la pendiente de la pendiente. Existen dos tipos de curvatura de salida opcionales posibles: la curvatura del perfil está en la dirección de la pendiente máxima y la curvatura del plano es perpendicular a la dirección de la pendiente máxima.
Una curvatura positiva indica que la superficie es convexa hacia arriba en esa celda. Una curvatura negativa indica que la superficie es cóncava hacia arriba en esa celda. Un valor 0 indica que la superficie es plana.
En la salida del perfil, un valor negativo indica que la superficie es convexa hacia arriba en esa celda. Un perfil positivo indica que la superficie es cóncava hacia arriba en esa celda. Un valor 0 indica que la superficie es plana.
En la salida del plano, un valor positivo indica que la superficie es convexa hacia arriba en esa celda. Un plano negativo indica que la superficie es cóncava hacia arriba en esa celda. Un valor 0 indica que la superficie es plana.
Las unidades del ráster de curvatura de salida, así como las unidades del ráster de curvatura de perfil de salida opcional y el ráster de curvatura plana de salida son una centésima parte (1/100) de una unidad z. Los valores razonablemente esperados de los tres rásteres de salida de un área accidentada (relieve moderado) pueden variar de -0,5 a 0,5; mientras que para montañas empinadas y escarpadas (relieve extremo), los valores pueden variar entre -4 y 4. Tenga en cuenta que es posible exceder este rango para ciertas superficies de ráster.
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 que se aplican a esta herramienta.
Sintaxis
Curvature(in_raster, {z_factor}, {out_profile_curve_raster}, {out_plan_curve_raster})
Parámetro | Explicación | Tipo de datos |
in_raster | Ráster de entrada de superficie. | Raster Layer |
z_factor (Opcional) | 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 |
out_profile_curve_raster (Opcional) | Dataset ráster de curvatura de perfil de salida. Esta es la curvatura de la superficie en la dirección de la pendiente. Será de tipo punto flotante. | Raster Dataset |
out_plan_curve_raster (Opcional) | Dataset ráster de curvatura plana de salida. Esta es la curvatura de la superficie perpendicular a la dirección de la pendiente. Será de tipo punto flotante. | Raster Dataset |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_curvature_raster | Ráster de curvatura de salida. Será de tipo punto flotante. | Raster |
Muestra de código
Ejemplo 1 de Curvatura (ventana de Python)
En este ejemplo se crea un ráster de curvatura a partir de un ráster de superficie de entrada y también se aplica un factor z.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCurve = Curvature("elevation", 1.094)
outCurve.save("C:/sapyexamples/output/outcurv01")
Ejemplo 2 de Curvatura (script independiente)
En este ejemplo se crea un ráster de curvatura a partir de un ráster de superficie de entrada y también se aplica un factor z.
# Name: Curvature_Ex_02.py
# Description: Calculates the curvature of a raster surface,
# optionally including profile and plan curvature.
# 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"
zFactor = 1.094
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Curvature
outCurve = Curvature(inRaster, 1.094)
# Save the output
outCurve.save("C:/sapyexamples/output/outcurv02")
Entornos
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