Disponible con una licencia de 3D Analyst.
Resumen
Convierte un dataset de terreno en un dataset de red irregular de triángulos (TIN).
Uso
Define la extensión del TIN de salida utilizando la configuración de entorno de extensión de geoprocesamiento.
Utilice una extensión y un nivel de pirámide que no excederá el límite de nodo una TIN. Mientras se estima que el número máximo de nodos de la TIN en una plataforma de ventana de 32 bits está entre 15 a 20 millones, un tope de unos cuantos millones se recomienda para mantener el rendimiento optimo de la visualización. La triangulación de una superficie más grande la maneja mejor el dataset de terreno.
Sintaxis
arcpy.3d.TerrainToTin(in_terrain, out_tin, {pyramid_level_resolution}, {max_nodes}, {clip_to_extent})
Parámetro | Explicación | Tipo de datos |
in_terrain | El dataset de terreno que se va a procesar. | Terrain Layer |
out_tin | EL dataset de TIN que se va a generar. | TIN |
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 utilizará esta herramienta. El valor predeterminado es 0, o resolución completa. | Double |
max_nodes (Opcional) | La cantidad máxima de nodos permitida en el TIN de salida. La herramienta devolverá un error si la extensión de análisis y el nivel de pirámide producirían un TIN que supere este tamaño. El valor predeterminado es 5 millones. | Long |
clip_to_extent (Opcional) | Especifica si la TIN que resulta se recortará contra la extensión de análisis. Esto sólo tiene efecto si se define la extensión del análisis y es más pequeña que la extensión del terreno de entrada.
| Boolean |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = "C:/data"
arcpy.TerrainToTin_3d("sample.gdb/featuredataset/terrain", "tin",
pyramid_level_resolution=6, max_nodes=4000000)
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''*********************************************************************
Name: TerrainToTin Example
Description: This script demonstrates how to use the
TerrainToTin tool.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inTerrain = "sample.gdb/featuredataset/terrain"
pyrRes = 6
maxNodes = 5000000
clipExtent = False
# Ensure output name is unique
outTIN = arcpy.CreateUniqueName("tin")
#Execute TerrainToTin
arcpy.TerrainToTin_3d(inTerrain, outTIN, pyrRes, maxNodes, clipExtent)
del arcpy
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst