TIN Compare (Data Management)
Summary
Compares two TINs and returns the comparison results. TIN Compare can report differences with geometry, TIN node and triangle tags, and spatial reference.
Usage
-
The tool returns messages showing the comparison result. By default, the tool will stop executing after encountering the first miscompare. To report all differences, set the continue compare option to true.
-
The Output Compare File will contain all similarities and differences between the Input Base TIN and the Input Test TIN. This file is a comma-delimited text file which can be viewed and used as a table in ArcGIS. For example, this table can be queried to obtain all the ObjectID values for all the rows that are different.
-
The comparison tools result object will be 'true' when no differences are found and 'false' when differences are detected.
Syntax
Parameter | Explanation | Data Type |
in_base_tin |
The Input Base Tin is compared with the Input Test Tin. Input Base Tin refers to data that you have declared valid. This base data has the correct geometry, tag values (if any), and spatial reference. | TIN Layer |
in_test_tin |
The Input Test Tin is compared against the Input Base Tin. | TIN Layer |
compare_type (Optional) |
The comparison type.
| String |
continue_compare (Optional) |
Indicates whether to compare all properties after encountering the first mismatch.
| Boolean |
out_compare_file (Optional) |
The name and path of the text file which will contain the comparison results. | File |
Code Sample
The following Python window script demonstrates how to use the TinCompare function in immediate mode.
import arcpy
arcpy.TinCompare_management(r'c:\Workspace\basetin', r'c:\Workspace\newtin', 'ALL', 'CONTINUE_COMPARE', r'c:\Workspace\tincompare.txt')
Example of how to use the TinCompare tool in a stand-alone script.
# Name: TinCompare.py
# Description: Compare two TINs and return comparison result.
# import system modules
import arcpy
try:
# Set local variables
base_tin= "C:/Workspace/basetin"
test_tin= "C:/Workspace/newtin"
compare_type = "ALL"
continue_compare = "CONTINUE_COMPARE"
compare_file = "C:/Workspace/tincompare.txt"
# Process: TinCompare
compare_result = arcpy.TinCompare_management(base_tin, test_tin, compare_type, continue_compare, compare_file)
print compare_result
print arcpy.GetMessages()
except:
# Print error message if an error occurs
print arcpy.GetMessages()