Orientación de superficie (3D Analyst)
Resumen
Calcula la orientación o la dirección de la pendiente descendente más empinada, de cada triángulo en una TIN o dataset de terreno y escribe la salida como una clase de entidad poligonal.
Ilustración
Uso
Cada orientación del triángulo de superficie se determina en unidades de grados, luego de haber asignado un código de orientación basado en la dirección cardinal u ordinal de su pendiente. El esquema de clasificación predeterminado se define de la siguiente manera:
Código
Dirección de la pendiente
Rango del ángulo de la pendiente
-1
Plano
Sin pendiente
1
Norte
0–22.5
2
Noreste
22.5–45
Este
3
45–135 135–180
Sureste
4
5
Sur
180–225
6
Suroeste
225–270
7
Oeste
270–315
8
Noroeste
315–337.5
9
Norte
337.5–360
Los triángulos contiguos del mismo código se fusionan en una entidad.
Las definiciones de clases personalizadas se pueden proporcionar a través de una Tabla de cortes de clase. La tabla debe tener dos columnas donde la primera indique el punto de corte de orientación en grados y la segunda defina su valor de código. Considere los siguientes ejemplos:
Corte
Aspect_Code
90.0
1
180.0
2
270.0
3
360.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.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_surface |
La superficie TIN o de terreno de entrada. | Terrain Layer; TIN Layer |
out_feature_class |
The output feature class. | Feature Class |
class_breaks_table (Opcional) |
Una tabla que contiene los cortes de clasificación que se utilizarán para definir los rangos de orientación en la clase de entidad de salida. | Table |
aspect_field (Opcional) |
El campo que contiene los valores del código de orientación. | String |
pyramid_level_resolution (Opcional) |
The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution. | Double |
Ejemplo de código
The following sample demonstrates the use of this tool in the Python window:
import arcpy from arcpy import env arcpy.CheckOutExtension("3D") env.workspace = "C:/data" arcpy.SurfaceVolume_3d("sample.gdb/featuredataset/terrain", "surf_vol.txt", "ABOVE", 300, 1, 5)
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''**************************************************************************** Name: Surface Volume Example Description: This script demonstrates how to use the Surface Volume tool. ****************************************************************************''' # Import system modules import arcpy from arcpy import env import exceptions, sys, traceback try: # Obtain a license for the ArcGIS 3D Analyst extension arcpy.CheckOutExtension("3D") # Set environment settings env.workspace = "C:/data" # Set Local Variables inSurface = "elevation_tin" #Execute SurfaceVolume result = arcpy.SurfaceVolume_3d(inSurface, "", "ABOVE", "300", "1", "5") print result.GetMessage(0) except arcpy.ExecuteError: print arcpy.GetMessages() except: # Get the traceback object tb = sys.exc_info()[2] tbinfo = traceback.format_tb(tb)[0] # Concatenate error information into message string pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\ .format(tbinfo, str(sys.exc_info()[1])) msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2)) # Return python error messages for script tool or Python Window arcpy.AddError(pymsg) arcpy.AddError(msgs)