Pendiente de superficie (3D Analyst)

Resumen

Crea entidades de polígono que representan rangos de valores de pendiente de superficies trianguladas.

Ilustración

Pendiente de superficie

Uso

  • La superficie normal de cada triángulo, determinada por el producto cruzado de los vectores de dos aristas de triángulo, se utiliza para determinar la pendiente en porcentaje y grados. La pendiente en porcentaje describe la proporción de cambio en altura de la superficie normal con respecto al cambio en la distancia horizontal, mientras que la pendiente en grados es el ángulo de inclinación entre la superficie normal y un plano horizontal.

  • Cada uno de los polígonos resultantes representa un rango de valores de pendiente basados en los cortes de clasificación usados al ejecutar la herramienta. Los cortes de clasificación predeterminados dividen las mediciones de pendiente en los nueve grupos siguientes:

    CÓDIGO DE PENDIENTEPERCENT RANGO DE GRADOS

    1

    0,00-1,00

    0,00-0,57

    2

    1,00-2,15

    0,57-1,43

    3

    2,15-4,64

    1,43-2,66

    4

    4,64-10,0

    2,66-5,71

    5

    10,00-21,50

    5,71-12,13

    6

    21,50-46,40

    12,13-24,89

    7

    46,40-100,0

    24,89-45,00

    8

    100,0-1.000,0

    45,00-84,29

    9

    1.000,0 <

    84,29-90,0

  • Las clasificaciones de pendiente se pueden personalizar especificando una tabla formada como máximo por dos campos de valores numéricos en el parámetro Tabla de rupturas de clase. La primera columna identifica los puntos de corte de la clasificación de pendiente. Si se proporciona una segunda columna, sus valores se usarán para asociar un código que recibe atributos para cada entidad poligonal. Si se ha usado la tabla siguiente, todos los valores de pendiente de 0 a 10 se representarán mediante un código 1, 10 a 25, mediante un código 2, y así sucesivamente. Las unidades de ruptura de clase de la tabla están definidas en el parámetro Unidades de pendiente (units).

    CLASS_BREAKCÓDIGO

    10.0

    1

    25,0

    2

    40,0

    3

    70,0

    4

    La tabla puede estar en cualquier formato compatible (.dbf, .txt, o tabla de geodatabase). El nombre de los campos son irrelevantes, ya que el primero siempre se utilizará para los cortes de clase y el segundo para los códigos de orientación.

Parámetros

EtiquetaExplicaciónTipo de datos
Superficie de Entrada

Dataset de TIN, terreno o LAS cuyas mediciones de pendiente se escribirán en la entidad poligonal de salida.

LAS Dataset Layer; Terrain Layer; TIN Layer
Clase de entidad de salida

La clase de entidad que generará.

Feature Class
Unidades Pendiente
(Opcional)

Las unidades de medida que se utilizarán para el cálculo de la pendiente.

  • Por cientoLa pendiente se expresa como un valor de porcentaje. Esta es la opción predeterminada.
  • GradoLa pendiente se expresa como el ángulo de inclinación desde un plano horizontal.
String
Tabla de Rupturas de Clase
(Opcional)

Una tabla que contiene los cortes de clasificación que se utilizarán para agrupar las entidades de salida. La primera columna de esta tabla indicará el punto de corte, mientras que la segunda proporcionará el código de clasificación.

Table
Campo Pendiente
(Opcional)

El campo que contiene los valores de pendiente.

String
Factor Z
(Opcional)

El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.

Double
Resolución de nivel de pirámide
(Opcional)

La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.

Double

arcpy.ddd.SurfaceSlope(in_surface, out_feature_class, {units}, {class_breaks_table}, {slope_field}, {z_factor}, {pyramid_level_resolution})
NombreExplicaciónTipo de datos
in_surface

Dataset de TIN, terreno o LAS cuyas mediciones de pendiente se escribirán en la entidad poligonal de salida.

LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class

La clase de entidad que generará.

Feature Class
units
(Opcional)

Las unidades de medida que se utilizarán para el cálculo de la pendiente.

  • PERCENTLa pendiente se expresa como un valor de porcentaje. Esta es la opción predeterminada.
  • DEGREELa pendiente se expresa como el ángulo de inclinación desde un plano horizontal.
String
class_breaks_table
(Opcional)

Una tabla que contiene los cortes de clasificación que se utilizarán para agrupar las entidades de salida. La primera columna de esta tabla indicará el punto de corte, mientras que la segunda proporcionará el código de clasificación.

Table
slope_field
(Opcional)

El campo que contiene los valores de pendiente.

String
z_factor
(Opcional)

El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.

Double
pyramid_level_resolution
(Opcional)

La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.

Double

Muestra de código

Ejemplo 1 de SurfaceSlope (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceSlope("sample.gdb/featuredataset/terrain", "slope.shp", "PERCENT")
Ejemplo 2 de SurfaceSlope (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

'''****************************************************************************
Name: SurfaceSlope Example
Description: This script demonstrates how to use the
             SurfaceAspect and SurfaceSlope tools to generate a polygon
             that contains the intersection of both
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# List all TINs in workspace
listTINs = arcpy.ListDatasets("","TIN")

# Determine whether the list contains any TINs
if len(listTINs) > 0:
    for dataset in listTINs:
        print(dataset)
        # Set Local Variables
        aspect = arcpy.CreateUniqueName("Aspect.shp")
        slope = arcpy.CreateUniqueName("Slope.shp")
        outFC = dataset + "_Aspect_Slope.shp"
        #Execute SurfaceAspect
        arcpy.ddd.SurfaceAspect(dataset, aspect)
        #Execute SurfaceSlope
        arcpy.ddd.SurfaceSlope(dataset, slope)
        #Execute SurfaceSlope
        print("Starting Intersect")
        arcpy.analysis.Intersect(aspect + " #;" + slope + " #", outFC, "ALL")
        print("Completed intersect for " + dataset)
else:
    print("There are no TINs in the " + env.workspace + " directory.")

Información de licenciamiento

  • Basic: Requiere 3D Analyst
  • Standard: Requiere 3D Analyst
  • Advanced: Requiere 3D Analyst

Temas relacionados