要素比较 (数据管理)
摘要
比较两个要素类或图层并返回比较结果。要素比较可以对几何、表格值、空间参考和字段定义方面存在的差异进行报告。
用法
-
此工具可返回显示比较结果的信息。默认情况下，该工具将在遇到第一个错误比较后停止执行。要报告所有差异，需将继续比较选项设置为“真”。
-
可以指定多个排序字段。先排序第一个字段，然后排序第二个字段，依此类推（以升序排列）。在输入基础要素与输入测试要素中均使用公用字段进行排序，可确保正在对各输入数据集中相同的行进行比较。
-
默认情况下，比较类型设置为 ALL。这表示进行比较的要素的所有属性都将被选中，包括空间参考、字段属性、特性和几何这些内容。但是，您可以选择其他比较类型，以只选中要执行比较的要素的特定属性。
-
忽略选项为操作提供了灵活性，使用户可以忽略诸如测量特性、z 特性、点 ID 特性和扩展属性之类的属性。这两个要素类可能是相同的，但一个拥有测量值和 z 坐标，而另一个没有。您可以选择忽略这些属性。IGNORE_EXTENSION_PROPERTIES 选项涉及到添加到要素类或表的其他信息。例如，两个注记要素类的要素可能相同，但要素类可能具有不同的扩展属性，如符号集中的符号不同并且编辑行为不同。
-
默认的“XY 容差”根据“输入基础要素”的默认“XY 容差”确定。要使误差最小，所选的比较容差值应尽量小。如果输入的“XY 容差”为零，则会执行精确匹配。
-
默认的“M 容差”和默认的“Z 容差”由输入基础要素的默认“M 容差”和“Z 容差”确定。单位与输入基础要素的单位相同。如果输入的“M 容差”和“Z 容差”为零，则会执行精确匹配。
-
在比较 GEOMETRY_ONLY 时，空间参考必须匹配。如果空间参考不同，将会报告错误比较。如果二者之中任意一个坐标系的输入不同，则要素都会得出错误比较结果。此工具无法执行动态投影。
-
忽略字段参数是字段计数比较所不包含的字段列表，它们的字段定义和表格值均被忽略。
-
只能为数值字段类型指定属性容差。
-
输出比较文件将包含输入基础要素与输入测试要素之间的所有相似和差异。该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。例如，可通过查询该表获得存在差异的所有行的所有 ObjectID 值。“有误差”字段指示记录包含误差。“真”表示存在差异。
要素计数是首先要执行的一项比较操作。如果要素计数报告指出存在差异并且继续比较参数值为“真”，则随后出现的比较消息并不能准确反映输入基础要素和输入测试要素之间的其他差异。这是由于要素比较并不能识别出输入测试要素中添加或删除要素的位置，只能移动到各属性表的下一行。在属性表中添加或删除了要素的位置，工具只是移动到下一行并开始对基础要素和错误的测试要素进行比较，这是因为输入测试数据中对应的测试要素已删除，或者该要素前插入了其他要素。
-
比较工具结果对象在未找到差异时将为“真”，在检测到差异时则为“假”。
语法
| 参数 | 说明 | 数据类型 |
in_base_features |
将“输入基础要素”与“输入测试要素”进行比较。“输入基础要素”是指已声明有效的数据。该基础数据具有正确的几何定义、字段定义以及空间参考。 | Feature Layer |
in_test_features |
将“输入测试要素”与“输入基础要素”进行比较。“输入测试要素”是指因编辑或编译新要素而被更改的数据。 | Feature Layer |
sort_field [sort_field,...] |
在“输入基础表”和“输入测试表”中排序记录时要使用的一个或多个字段。记录将以升序进行排序。在“输入基础要素”与“输入测试要素”中均使用公用字段进行排序，可确保正在对各输入数据集中相同的行进行比较。 | Value Table |
compare_type (可选) |
比较类型。默认设置为 ALL。使用该默认设置将对待比较的要素的所有属性进行比较。
| String |
ignore_options [ignore_option,...] (可选) |
在比较过程中不会对以下属性进行比较。
| String |
xy_tolerance (可选) |
落在此距离范围内的要素被视作相同。要使误差最小，所选的比较容差值应尽量小。默认情况下，比较容差就是输入基础要素的“XY 容差”。 | Linear unit |
m_tolerance (可选) |
测量容差是测量值间所允许的最小距离，如果两个测量值之间的距离在此范围内，它们会被视为相同。 | Double |
z_tolerance (可选) |
“Z 容差”是 Z 坐标间所允许的最小距离，如果两个坐标之间的距离在此范围内，它们会被视为同一坐标。 | Double |
attribute_tolerances [[Field, {Tolerance}],...] (可选) |
在该数值范围内的属性值将被视作相同。它仅适用于数值字段类型。 | Value Table |
omit_field [omit_field,...] (可选) |
在比较过程中将被忽略的一个或多个字段。这些字段的字段定义和表格值将被忽略。 | String |
continue_compare (可选) |
指示在遇到第一个不匹配项后是否继续比较所有属性。
| Boolean |
out_compare_file (可选) |
该文件将包含“输入基础要素”与“输入测试要素”之间所有的相似和存在差异之处。该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。 | File |
代码实例
下面的 Python 窗口脚本演示了如何在即时模式下使用 FeatureCompare 函数。
import arcpy
arcpy.FeatureCompare_management(r'C:/Workspace/baseroads.shp', r'C:/Workspace/newroads.shp', 'ROAD_ID', 'ALL', 'IGNORE_M;IGNORE_Z', '0.001 METERS', 0, 0, 'Shape_Length 0.001', '#', 'CONTINUE_COMPARE', e = r'C:/Workspace/roadcompare.txt')
如何在独立脚本中使用 FeatureCompare 工具的示例。
# Name: FeatureCompare.py
# Description: Compare two feature classes and return comparison result.
# import system modules
import arcpy
try:
# Set local variables
base_features = "C:/Workspace/baseroads.shp"
test_features = "C:/Workspace/newroads.shp"
sort_field = "ROAD_ID"
compare_type = "ALL"
ignore_option = "IGNORE_M;IGNORE_Z"
xy_tolerance = "0.001 METERS"
m_tolerance = 0
z_tolerance = 0
attribute_tolerance = "Shape_Length 0.001"
omit_field = "#"
continue_compare = "CONTINUE_COMPARE"
compare_file = "C:/Workspace/roadcompare.txt"
# Process: FeatureCompare
compare_result = arcpy.FeatureCompare_management(base_features, test_features, sort_field, compare_type, ignore_option, xy_tolerance, m_tolerance, z_tolerance, attribute_tolerance, omit_field, continue_compare, compare_file)
print compare_result
print arcpy.GetMessages()
except:
# Print error message if an error occurs
print arcpy.GetMessages()