Triángulo del TIN (3D Analyst)

Resumen

Exporta caras de triángulo desde un dataset de TIN hasta entidades poligonales y proporciona la pendiente, el aspecto y atributos opcionales de sombreado y valores de etiqueta para cada triángulo.

Ilustración

Ilustración de Triángulo del TIN

Uso

  • La pendiente y los cálculos de orientación se basan en el plano del triángulo. La pendiente no se puede calcular correctamente si la unidad lineal del sistema de coordenadas del TIN utiliza medidas angulares, como grados decimales.

  • Las unidades lineales XY y Z deben estar en la misma unidad de medida para que los cálculos de sombreado y de la pendiente proporcionen resultados precisos. Si las unidades difieren pero el TIN tiene sus sistemas de coordenadas verticales y horizontales definidos, un factor Z apropiado se determina automáticamente. De lo contrario, el parámetro del Factor Z se puede utilizar para definir explícitamente el factor de conversión que se aplicará en los valores de elevación.

  • Los valores de orientación se expresan en grados y asumen que Norte es 0°. Los valores aumentan a la derecha y se registran en el campo Orientación. Un valor de orientación de -1 se asigna para cualquier triángulo plano en el TIN.

  • La pendiente se puede devolver en grados o porcentaje, y el nombre de campo en el que están registrados los valores depende de la selección realizada en el parámetro Unidades de pendiente:

    • PORCENTAJE: los valores de la pendiente se almacenarán en un campo denominado Slope_Pct.
    • GRADO: los valores de la pendiente se almacenarán en un campo denominado Slope_Deg.
  • Los valores de sombreado reflejan el relieve localizado producido desde una fuente de luz que asume el acimut y el ángulo vertical especificado en el parámetro de sombreado. Se asume que el 0° es el Norte para el acimut y el valor de brillo se expresa de 0 a 255, donde, cuanto menor es el número, más oscura es la sombra.

  • El parámetro Campo de valor de etiqueta solo estará activo si el TIN tiene valores de etiqueta que se definieron explícitamente.

Parámetros

EtiquetaExplicaciónTipo de datos
TIN de entrada

El dataset TIN que se procesará.

TIN Layer
Clase de entidad de salida

La clase de entidad que generará.

Feature Class
Unidades de pendiente
(Opcional)

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

  • PorcentajeLa 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
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
SOMBREADO ángulo acimutal, altitud
(Opcional)

Especifica los ángulo acimut y de altitud del origen de luz al aplicar un efecto de sombreado para la salida de la capa de entidades. Acimut puede variar de 0 a 360 grados, considerando que la altitud puede variar de 0 a 90. Un acimut de 45 grados y la altitud de 30 grados se ingresará como "HILLSHADE 45, 30".

String
Campo del valor tag
(Opcional)

El nombre de campo en la entidad de salida que almacenará el valor de etiqueta del triángulo. Este parámetro está vacío por defecto, lo que resultará en valores de etiqueta no escritos en la salida.

String

arcpy.ddd.TinTriangle(in_tin, out_feature_class, {units}, {z_factor}, {hillshade}, {tag_field})
NombreExplicaciónTipo de datos
in_tin

El dataset TIN que se procesará.

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
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
hillshade
HILLSHADE <azimuth>, <angle>
(Opcional)

Especifica los ángulo acimut y de altitud del origen de luz al aplicar un efecto de sombreado para la salida de la capa de entidades. Acimut puede variar de 0 a 360 grados, considerando que la altitud puede variar de 0 a 90. Un acimut de 45 grados y la altitud de 30 grados se ingresará como "HILLSHADE 45, 30".

String
tag_field
(Opcional)

El nombre de campo en la entidad de salida que almacenará el valor de etiqueta del triángulo. Este parámetro está vacío por defecto, lo que resultará en valores de etiqueta no escritos en la salida.

String

Muestra de código

Ejemplo 1 de TinTriangle (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.TinTriangle("tin", "tin_triangle.shp", units="DEGREE", 
                      z_factor=1, hillshade="HILLSHADE 310,45", tag_field="tag")
Ejemplo 2 de TinTriangle (secuencia de comandos independiente)

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

'''****************************************************************************
Name: TinTriangle Example
Description: This script demonstrates how to use the 
             TinTriangle tool to extract triangles from each TIN in the 
             target workspace.
****************************************************************************'''
# Import system modules
import arcpy

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

# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")

# Verify the presence of TINs in the list
if TINList:
    for dataset in TINList:
        # Set Local Variables
        TINList = arcpy.ListDatasets("*", "Tin")
        slopeUnits = "PERCENT"
        zfactor = 1
        hillshade = "HILLSHADE 300, 45" # defines hillshade azimuth & angle
        tagField = "Tag"
        Output = dataset + "_triangles.shp" # name of the output file
        #Execute TinTriangle
        arcpy.ddd.TinTriangle(dataset, Output, slopeUnits, zfactor,
                              hillshade, tagField)
        print("Finished.")
else:
    print("There are no TIN(s) in the " + env.workspace + " directory.")

Información de licenciamiento

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

Temas relacionados