裁剪 (分析)

摘要

提取与裁剪要素相叠加的输入要素。

此工具用于以其他要素类中的一个或多个要素作为“模具”来剪切掉要素类的一部分。在您想要创建一个包含另一较大要素类的地理要素子集的新要素类（也称为研究区域或感兴趣区域 (AOI)）时，裁剪工具尤为有用。

插图

用法

• 裁剪要素数据集必须是面。

• 输出要素类将包含输入要素的所有属性。

• 此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息，请参阅对大型数据集进行地理处理。

• 由面要素裁剪的线要素

• 由面要素裁剪的点要素

• 输入要素类的属性值将被复制到输出要素类。但是，如果输入图层是通过创建要素图层工具创建的并且选中了字段的“使用比率策略”选项，则将计算输出属性值与输入属性值的比率。如果启用了“使用比率策略”选项，分割叠加操作中的要素时，将按输入要素属性值的一定比例生成要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如，如果输入几何被分割成相等的两部分，则每个新要素的属性值都等于输入要素属性值的一半。“使用比率策略”仅适用于数值字段类型。

  警告:

  地理处理工具不支持地理数据库要素类或表字段分割策略。

语法

Clip_analysis (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 方向移动的距离。如果将此值设置得较高，则数据的坐标精度将会较低；如果将此值设置得较低，则数据的坐标精度将会较高。	Linear unit

代码示例

 import arcpy from arcpy import env  env.workspace = "c:/basedata/vegetation.gdb" arcpy.Clip_analysis("vegetation", "stream_buffers", "veg_within_stream_buffers")

裁剪示例（Python 窗口）

以下 Python 窗口脚本演示了如何在立即模式下使用“裁剪”函数。

import arcpy from arcpy import env  env.workspace = "C:/data" arcpy.Clip_analysis("majorrds.shp", "study_quads.shp", "C:/output/studyarea.shp")

裁剪示例 2（独立 Python 脚本）

以下 Python 脚本演示了如何在独立脚本中使用“裁剪”函数。

 # Name: Clip_Example2.py # Description: Clip major roads that fall within the gnatcatcher habitat study area.  # Author: ESRI  # Import system modules import arcpy from arcpy import env  # Set workspace env.workspace = "C:/data"  # Set local variables in_features = "majorrds.shp" clip_features = "study_quads.shp" out_feature_class = "C:/output/studyarea.shp" xy_tolerance = ""  # Execute Clip arcpy.Clip_analysis(in_features, clip_features, out_feature_class, xy_tolerance)      

环境

默认输出 Z 值, M 分辨率, M 容差, 输出配置关键字, 输出 M 属性域, 输出 XY 属性域, 输出 Z 属性域, 输出坐标系, 范围, 输出包含 M 值, 输出包含 Z 值, 输出空间格网 1、2、3, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

ArcView: 是

ArcEditor: 是

ArcInfo: 是