Curvatura (Spatial 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. Hay dos tipos de curvatura de salida opcionales: 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 esperados razonablemente de los tres rásteres de salida de un área accidentada (alivio moderado) pueden variar de -0.5 a 0.5; mientras que para montañas empinadas accidentadas (alivio extremo), los valores pueden variar entre -4 y 4. Tenga en cuenta que es posible exceder este rango para ciertas superficies de ráster.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_raster |
Gáster de entrada de superficie. | Raster Layer |
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 |
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. | 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. | Raster Dataset |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_curvature_raster |
Ráster de curvatura de salida. | Raster |
Ejemplo de código
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")
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")