Disponible con una licencia de 3D Analyst.
Resumen
Convierte un ráster en un dataset de red irregular de triángulos (TIN).
Ilustración
Uso
Convertir un ráster a un TIN, en sí mismo, no producirá una mejor superficie. Necesita datos secundarios que sean compatibles con la definición de la superficie y que la mejoren. Dichos datos se pueden agregar a la TIN con la herramienta Editar TIN.
La diferencia máxima permitida predeterminada entre la altura del ráster de entrada y la altura del TIN de salida es 1/10 del rango de z del ráster de entrada.
Aunque el tamaño máximo de un TIN que se puede utilizar bajo Win32 varía entre 15 y 20 millones de nodos, se recomienda establecer el tope de tamaño en unos pocos millones. Los rásteres de entrada grandes y la configuración de tolerancia z pequeña, pueden superar este valor. Si el tamaño es un problema, considere el procesamiento de subconjuntos.
Sintaxis
RasterTin_3d (in_raster, out_tin, {z_tolerance}, {max_points}, {z_factor})
Parámetro | Explicación | Tipo de datos |
in_raster | El ráster que se va a procesar. | Raster Layer; Mosaic Layer |
out_tin | EL dataset de TIN que se va a generar. | TIN |
z_tolerance (Opcional) | La diferencia máxima permitida (en unidades z) entre la altura del ráster de entrada y la altura del TIN de salida. Por defecto, la tolerancia z es 1/10 del rango de z del ráster de entrada. | Double |
max_points (Opcional) | La cantidad máxima de puntos que se agregarán al TIN antes de que el proceso termine. Por defecto, el proceso continuará hasta que se agreguen todos los puntos. | Long |
z_factor (Opcional) | El factor por el que se multiplicarán los valores de altura del ráster en el dataset de TIN resultante. Esto se utiliza generalmente para convertir las unidades Z para que coincidan con las unidades XY. | Double |
Muestra de código
Ejemplo 1 de RasterTin (ventana de Python)
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterTin_3d("vermont_ele.tif", "C:/output/TIN_VT", "2", "1000", "1")
Ejemplo 2 de RasterTin (secuencia de comandos independiente)
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''*********************************************************************
Name: RasterTin Example
Description: This script demonstrates how to use the
RasterTin tool to create a TIN for each IMG raster in the
target workspace.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
try:
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
zTol = 2
maxPts = 1500000
zFactor = 1
# [:-4] strips the last 4 characters (.img) from the raster name
outTin = "C:/Output/TIN_" + raster[:-4]
print "Creating TIN from " + raster + "."
#Execute RasterTin
arcpy.RasterTin_3d(raster, outTIN, zTol, maxPts, zFactor)
print "Finished."
else:
"There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere 3D Analyst
- ArcGIS Desktop Standard: Requiere 3D Analyst
- ArcGIS Desktop Advanced: Requiere 3D Analyst