描述
提取与裁剪要素相重叠的输入要素。
此工具用于以其他要素类中的一个或多个要素作为模具来剪切要素类的一部分。在您想要创建一个包含另一较大要素类的地理要素子集的新要素类（也称为研究区域或感兴趣区域 (AOI)）时，裁剪工具尤为有用。
备用工具适用于裁剪操作。有关详细信息，请参阅成对裁剪工具。
插图
使用方法
裁剪要素参数值可以是点、线和面，具体取决于输入要素参数类型。
- 当输入要素为面时，裁剪要素也必须为面。
- 当输入要素为线时，裁剪要素可以为线或面。用线要素裁剪线要素时，仅将重合的线或线段写入到输出中，如下图所示。
- 当输入要素为点时，裁剪要素可以为点、线或面。用点要素裁剪点要素时，仅将重合的点写入到输出中，如下图所示。用线要素裁剪点要素时，仅将与线要素重合的点写入到输出中。
输出要素类参数将包含输入要素参数的所有属性。
此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息，请参阅对大型数据集进行地理处理。
由面要素裁剪的线要素：
由面要素裁剪的点要素：
由线要素裁剪的线要素：
由点要素裁剪的点要素：
输入要素类的属性值将被复制到输出要素类。但是，如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项，那么计算输出属性值时将按输入属性值的一定比例进行计算。如果启用了使用比率策略选项，执行叠加操作时，对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如，如果输入几何被分割成相等的两部分，则每个新要素的属性值都等于输入要素属性值的一半。使用比率策略仅适用于数值字段类型。
警告：
地理处理工具不支持地理数据库要素类或表字段分割策略。
此工具支持并行处理因子环境。如果环境未设置（默认值）或者设置为 0，则将禁用并行处理。将环境设置为 100 将启用并行处理。
语法
arcpy.analysis.Clip(in_features, clip_features, out_feature_class, {cluster_tolerance})| 参数 | 说明 | 数据类型 |
in_features | 要裁剪的要素。 | Feature Layer |
clip_features | 用于裁剪输入要素的要素。 | Feature Layer |
out_feature_class | 待创建的要素类。 | Feature Class |
cluster_tolerance （可选） | 所有要素坐标之间的最小距离以及坐标可以沿 X 和/或 Y 方向移动的距离。如果数据的坐标精度较低，则设置较高的值；如果数据的坐标精度较高，则设置较低的值。 警告：更改此参数的值可能会导致出现故障或意外结果。建议不要修改此参数。已将其从工具对话框的视图中移除。默认情况下，将使用输入要素类的空间参考 x,y 容差属性。 | Linear Unit |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 Clip 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Clip_analysis("majorrds.shp", "study_quads.shp",
"C:/output/studyarea.shp")以下 Python 脚本演示了如何在独立脚本中使用 Clip 函数。
# Name: Clip_Example2.py
# Description: Clip major roads that fall within the study area.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
# Execute Clip
arcpy.Clip_analysis(in_features, clip_features, out_feature_class)环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是