| 标注 | 说明 | 数据类型 |
输入要素 | 输入要素类或图层。 | Feature Layer |
擦除要素 | 用于擦除重叠输入要素的要素。 | Feature Layer |
输出要素类 | 该要素类只包含与擦除要素不重叠的输入要素。 | Feature Class |
XY 容差 (可选) | 所有要素坐标（节点和折点）之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。 警告：更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下，将使用输入要素类的空间参考 x,y 容差属性。 | Linear Unit |
在 Advanced 许可等级下可用。
插图
使用情况
输入要素和擦除要素参数值之间重合的几何将被移除。
擦除要素参数值可以为点、线或面，只要输入要素参数值的要素类型等级与之相同或较低。 面擦除要素可用于擦除输入要素中的面、线或点；线擦除要素可用于擦除输入要素中的线或点；点擦除要素仅用于擦除输入要素中的点。
输入要素类的属性值将被复制到输出要素类。但是，如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项，那么计算输出属性值时将按输入属性值的一定比例进行计算。如果启用了使用比率策略选项，执行叠加操作时，对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如，如果输入几何被分割成相等的两部分，则每个新要素的属性值都等于输入要素属性值的一半。使用比率策略仅适用于数值字段类型。
警告：
地理处理工具不支持地理数据库要素类或表字段分割策略。
此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息，请参阅对大型数据集进行地理处理。
即使所有输入要素均属于单部件要素，此工具仍可能在输出中生成多部件要素。 如果不希望生成多部件要素，请对输出要素类使用多部件至单部件工具。
此工具支持并行处理因子环境。 如果环境未设置（默认值）或者设置为 0，则将禁用并行处理。 如将环境设置为 100，则将启用并行处理。 启用并行处理时，最多将使用 10 个内核。
参数
arcpy.analysis.Erase(in_features, erase_features, out_feature_class, {cluster_tolerance})| 名称 | 说明 | 数据类型 |
in_features | 输入要素类或图层。 | Feature Layer |
erase_features | 用于擦除重叠输入要素的要素。 | Feature Layer |
out_feature_class | 该要素类只包含与擦除要素不重叠的输入要素。 | Feature Class |
cluster_tolerance (可选) | 所有要素坐标（节点和折点）之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。 警告：更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下，将使用输入要素类的空间参考 x,y 容差属性。 | Linear Unit |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 Erase 函数。
import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.Erase_analysis(r'redlands.gdb\rdlswells\well',
r'redlands.gdb\rdlsfloodzones\flood',
r'redlands.gdb\wellsoutside_flood')查找尚未受主要道路严重影响的相应植被区域。
# Name: Erase.py
# Description: Find areas of suitable vegetation that exclude areas heavily
# impacted by major roads
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(roads, roadsBuffer, distanceField, "FULL", "ROUND",
"LIST", dissolveField)
# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
arcpy.Erase_analysis(suitableVeg, roadsBuffer, eraseOutput)环境
自动提交, 限定的字段名, 默认输出 Z 值, M 分辨率, M 容差, 输出配置关键字, 输出 M 属性域, 输出 XY 属性域, 输出 Z 属性域, 输出坐标系, 范围, 输出包含 M 值, 输出包含 Z 值, XY 分辨率, XY 容差, Z 分辨率, Z 容差, 并行处理因子, 传输字段域、子类型和属性规则
特殊情况
许可信息
- Basic: 否
- Standard: 否
- Advanced: 是