TIN Polygon Tag (3D Analyst)

Summary

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

Illustration

TIN Polygon Tag 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.

  • 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.

Parameters

LabelExplanationData Type
Input TIN

The TIN dataset that will be processed.

TIN Layer
Output Feature Class

The feature class that will be produced.

Feature Class
Tag Value Field
(Optional)

The name of the field storing the tag attribute in the output feature class. The default field name is Tag_Value.

String

arcpy.ddd.TinPolygonTag(in_tin, out_feature_class, {tag_field})
NameExplanationData Type
in_tin

The TIN dataset that will be processed.

TIN Layer
out_feature_class

The feature class that will be produced.

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.

arcpy.env.workspace = "C:/data"
arcpy.ddd.TinPolygonTag("tin", "tin_polytag.shp", tag_field="LanduseCode")
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

# Set environment settings
arcpy.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.ddd.TinPolygonTag(dataset, Output, TagFieldField)
    print("Finished.")
else:
    print("No TIN files reside in {0}".format(env.workspace))

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics