TIN Polygon Tag (3D Analyst)

Summary

Creates polygon features using tag values in a triangulated irregular network (TIN) dataset.

Illustration

Usage

• Tag values can be assigned using an integer field in a polygon feature class by loading the polygon into the TIN as a valuefill surface type. For more information on surface types, please read Fundamentals of editing TIN surfaces.

• Triangles that do not have a tag explicitly defined are assigned the default value of 0.

• All contiguous triangles with an identical tag value will be stored in a single polygon feature.

• The tag value will be denoted as an attribute in the output feature class.

Syntax

TinPolygonTag_3d (in_tin, out_feature_class, {tag_field})

Parameter	Explanation	Data Type
in_tin	The input TIN.	TIN Layer
out_feature_class	The output feature class.	Feature Class
tag_field (Optional)	The name of the field storing the tag attribute in the output feature class. The default field name is Tag_Value.	String

Code Sample

TinPolygonTag example 1 (Python window)

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.TinPolygonTag_3d("tin", "tin_polytag.shp", "Tag_Value")

TinPolygonTag example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''****************************************************************************
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)

Environments

Current Workspace, Scratch Workspace, Output Coordinate System, Extent, Geographic Transformations, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance, Output Z Domain, Output CONFIG Keyword, Auto Commit, Output Spatial Grid 1, 2, 3, Output XY Domain

Licensing Information

ArcView: Requires 3D Analyst

ArcEditor: Requires 3D Analyst

ArcInfo: Requires 3D Analyst