描述
提取与裁剪要素相重叠的输入要素。
此工具用于以其他要素类中的一个或多个要素作为模具来剪切要素类的一部分。在您想要创建一个包含另一较大要素类的地理要素子集的新要素类(也称为研究区域或感兴趣区域 (AOI))时,裁剪工具尤为有用。
备用工具适用于矢量数据裁剪操作。有关详细信息,请参阅裁剪工具。
插图
使用方法
裁剪要素参数值可以是点、线和面,具体取决于输入要素参数类型。
- 当输入要素为面时,裁剪要素也必须为面。
- 当输入要素为线时,裁剪要素可以为线或面。用线要素裁剪线要素时,仅将重合的线或线段写入到输出中,如下图所示。
- 当输入要素为点时,裁剪要素可以为点、线或面。用点要素裁剪点要素时,仅将重合的点写入到输出中,如下图所示。用线要素裁剪点要素时,仅将与线要素重合的点写入到输出中。
输出要素类参数将包含输入要素参数的所有属性。
由面要素裁剪的线要素:
由面要素裁剪的点要素:
由线要素裁剪的线要素:
由点要素裁剪的点要素:
此工具支持并行处理因子环境。如果环境未设置(默认情况下)或设置为 100,则将启用完全并行处理,同时该工具尝试将工作分配给计算机上的所有逻辑内核。将环境设置为 0 将禁用并行处理。在 1 到 99 之间指定一个因子时,工具将通过应用公式(并行处理因子 / 100 * 逻辑内核数)确定要使用的逻辑内核的百分比,其结果将向上舍入到最近的整数值。如果此公式的结果是 0 或 1,则将不启用并行处理。
语法
arcpy.analysis.PairwiseClip(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 窗口脚本演示了如何在即时模式下使用 PairwiseClip 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("majorrds.shp", "study_quads.shp",
"C:/output/studyarea.shp")
以下 Python 脚本演示了如何在独立脚本中使用 PairwiseClip 函数。
# Name: PairwiseClip_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 Pairwise Clip
arcpy.PairwiseClip_analysis(in_features, clip_features, out_feature_class)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是