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
This tool returns messages showing the comparison result. By default, it will stop executing after encountering the first miscompare. To report all differences, check on the Continue Comparison parameter.
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.
When using this tool in Python, you can get the status of this tool using result.getOutput(1). The value will be 'true' when no differences are found and 'false' when differences are detected.
Syntax
TINCompare_management (in_base_tin, in_test_tin, {compare_type}, {continue_compare}, {out_compare_file})
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
TINCompare Example (Python Window)
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')
TINCompare tool Example (Stand-alone script)
Example of how to use the TINCompare tool in a stand-alone script.
# Description: Compare two TINs and return comparison result.
# import system modules
import arcpy
# 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"
compare_result = arcpy.TINCompare_management(base_tin, test_tin, compare_type, continue_compare, compare_file)
print(compare_result)
print(arcpy.GetMessages())
Environments
This tool does not use any geoprocessing environments
Licensing information
- ArcGIS Desktop Basic: Yes
- ArcGIS Desktop Standard: Yes
- ArcGIS Desktop Advanced: Yes