计算默认 XY 容差 (数据管理)
摘要
通过检查要素类的空间参考和范围来计算默认 XY 容差。
对于地理数据库要素类,该工具返回的值将与地理数据库要素类或数据集的 XY 容差属性或者拓扑的拓扑容差相同。对于非地理数据库要素类(如 coverage 要素类、shapefile 或 CAD 要素类),该值将基于要素类空间参考的默认容差。
术语“XY 容差”和“拓扑容差”同义。在拓扑、python 脚本和 ArcGIS 9.2 之前的版本中介绍了“拓扑容差”的用法。该工具在脚本中的名称是 CalculateDefaultClusterTolerance。
通过 SpatialReference 对象的 XYTolerance 属性,也可在脚本中使用 XY 容差。SpatialReference 对象可通过描述要素类创建。
用法
该工具不能用于重置默认 XY 容差的值,而只能计算 XY 容差值。
该工具将以消息的形式返回其结果。结果值可在地理处理结果 窗口中查看,通过访问该工具执行的 result 对象还可将值指定给脚本中的某个变量。
-
虽然非地理数据库要素类的默认 XY 容差可能会因空间参考的不同而异,但其值都等于 0.001 米。无法更改该默认值。
如果在地理数据库中创建新要素类或其包含的要素数据集或拓扑,则可指定地理数据库要素类的 XY 容差。如果未指定新 XY 容差,则使用包含的要素类的默认值,该默认值通常等于 0.001 米。如果要素类保存在地理数据库的拓扑中,则可使用设置拓扑容差工具重置 XY 容差。有关详细信息,可通过以下方式获得:右键单击任一要素类或数据集,单击属性,选择容差选项卡,然后选中关于设置容差。
-
用来创建新要素类的大多数工具(如创建要素类或复制要素)都支持 XY_Tolerance 环境设置。但是,只有使用该环境设置的那些工具才会设置输出要素类的 XY 容差。输入 XY 容差不会受到该环境设置的影响。
语法
参数 | 说明 | 数据类型 |
in_features |
要计算默认 XY 容差的要素类。 | Feature Layer |
代码示例
以下 Python 窗口脚本演示了如何在立即模式下使用“计算默认拓扑容差”函数。
import arcpy from arcpy import env env.workspace = "C:/data" arcpy.CalculateDefaultClusterTolerance_management("roads.shp")
以下 Python 窗口脚本演示了如何在脚本环境中使用“计算默认拓扑容差”函数。
# Name: CalculateDefaultClusterTolerance_Example.py # Description: Calculate the default cluster tolerance of a shape file # Author: ESRI #Import the system modules import arcpy from arcpy import env env.workspace = "C:/temp" #Set local variables shapefileName = "linefc.shp" arcpy.CalculateDefaultClusterTolerance_management(shapefileName)