成对裁剪 (分析)

摘要

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

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

备用工具适用于矢量数据裁剪操作。 有关详细信息，请参阅裁剪工具。

插图

使用情况

• 裁剪要素参数值可以是点、线和面，具体取决于输入要素参数值。

  • 当输入要素参数值是面时，裁剪要素参数值必须也是面。
  • 当输入要素参数值为线时，裁剪要素参数值可以是线或者面。 用线要素裁剪线要素时，仅会将重合的线或线段写入到输出中，如下图所示。
  • 当输入要素参数值为点时，裁剪要素参数值可以是点、线或者面。 用点要素裁剪点要素时，仅会将重合的点写入到输出中，如下图所示。 用线要素裁剪点要素时，仅将与线要素重合的点写入到输出中。

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

• 由面要素裁剪的线要素：

  

• 由面要素裁剪的点要素：

  

• 由线要素裁剪的线要素：

  

• 由点要素裁剪的点要素：

  

• 此工具支持并行处理因子环境。如果环境未设置（默认情况下）或设置为 100，则将启用完全并行处理，同时该工具尝试将工作分配给计算机上的所有逻辑内核。将环境设置为 0 将禁用并行处理。在 1 到 99 之间指定一个因子时，工具将通过应用公式（并行处理因子 / 100 * 逻辑内核数）确定要使用的逻辑内核的百分比，其结果将向上舍入到最近的整数值。如果此公式的结果是 0 或 1，则将不启用并行处理。

参数

对话框

标注	说明	数据类型
输入要素	要裁剪的要素。	Feature Layer
裁剪要素	用于裁剪输入要素的要素。	Feature Layer
输出要素类	待创建的要素类。	Feature Class
XY 容差 (可选)	所有要素坐标（节点和折点）之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。 警告： 更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下，将使用输入要素类的空间参考 x,y 容差属性。	Linear Unit

Python

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

代码示例

PairwiseClip 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 PairwiseClip 函数。

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

PairwiseClip 示例 2（独立脚本）

以下 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)

环境

默认输出 Z 值, M 分辨率, M 容差, 输出配置关键字, 输出 M 属性域, 输出 XY 属性域, 输出 Z 属性域, 输出坐标系, 范围, 输出包含 M 值, 输出包含 Z 值, XY 分辨率, XY 容差, Z 分辨率, Z 容差, 并行处理因子, 维护曲线段, 传输字段域、子类型和属性规则

特殊情况

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是