Resumen
Crea entidades de polígono utilizando valores de etiqueta en un dataset de red irregular de triángulos (TIN).
Ilustración
Uso
Los valores de etiqueta se puede asignar con un campo de enteros en una clase de entidad de polígono al cargar el polígono dentro del TIN como un tipo de superficie de relleno de valor.
A los triángulos que no tienen una etiqueta asignada explícitamente se les asignan el valor predeterminado de 0.
Todos los triángulos contiguos con un valor de etiqueta idéntica se almacenarán en una entidad de polígono única.
El valor de etiqueta se denotará como un atributo en la clase de entidad de salida.
Sintaxis
TinPolygonTag_3d (in_tin, out_feature_class, {tag_field})
Parámetro | Explicación | Tipo de datos |
in_tin | El dataset de TIN que se va a procesar. | TIN Layer |
out_feature_class | La clase de entidad que generará esta herramienta. | Feature Class |
tag_field (Opcional) | El nombre del campo que almacena el atributo de etiqueta en la clase de entidad de salida. El nombre de campo predeterminado es Tag_Value. | String |
Ejemplo de código
Ejemplo 1 de TinPolygonTag (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.TinPolygonTag_3d("tin", "tin_polytag.shp", "Tag_Value")
Ejemplo 2 de TinPolygonTag (secuencia de comandos independiente)
En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.
'''****************************************************************************
Name: TinPolygonTag Example
Description: This script demonstrates use of the
TinPolygonTag tool to extract tag information
from each TIN in the target workspace.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
TagField = "Code"
# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")
# Verify the presence of TINs in the list
if TINList:
# Iterate through the list of TINs
for dataset in TINList:
# Define the name of the output file
Output = dataset + "_domain.shp"
# Execute TinPolygonTag
arcpy.TinPolygonTag_3d(dataset, Output, TagFieldField)
print "Finished."
else:
print "No TIN files reside in {0}".format(env.workspace)
arcpy.CheckInExtension("3D")
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)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere 3D Analyst
- ArcGIS for Desktop Standard: Requiere 3D Analyst
- ArcGIS for Desktop Advanced: Requiere 3D Analyst