裁剪图层 (GeoAnalytics Desktop)

摘要

从指定的多边形中提取输入要素。

插图

裁剪图层工具图示

使用情况

  • 使用裁剪图层来裁剪点、线或面要素。

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

  • 分析将裁剪覆盖感兴趣区域的要素或要素的各部分。

  • 输出结果将包含叠加裁剪图层面的输入图层要素。

  • 输出几何类型将与裁剪的输入要素相同。例如,如果在面内裁剪线要素,则输出结果将为线。

  • 输入图层参数中的所有字段都将包含在输出结果中。来自裁剪图层参数的字段将不包含在输出中。

  • 您可以执行以下其中一个或两个操作来提高裁剪图层工具的性能。

    • 设置范围环境,以便仅分析感兴趣的数据。
    • 本地数据用于分析运行的位置。

  • 此地理处理工具由 Spark 作为支持。 可在台式计算机上并行使用多个核来完成分析。 要了解有关运行分析的详细信息,请参阅 GeoAnalytics Desktop 工具的注意事项

  • 运行 GeoAnalytics Desktop 工具时,将在台式计算机上完成分析。 为获得最佳性能,应在桌面上提供数据。 如果使用的是托管要素图层,则建议您使用 ArcGIS GeoAnalytics Server。 如果您的数据不是本地数据,则运行工具需要更长时间。 要使用 ArcGIS GeoAnalytics Server 执行分析,请参阅 GeoAnalytics Tools

参数

标注说明数据类型
输入图层

包含要进行缓冲的点、线或面要素的数据集。

Feature Layer
裁剪图层

包含用于剪切输入要素的面要素的数据集。

Feature Layer
输出要素类

具有已裁剪要素的输出要素类。

Feature Class

arcpy.geoanalytics.ClipLayer(input_layer, clip_layer, out_feature_class)
名称说明数据类型
input_layer

包含要进行缓冲的点、线或面要素的数据集。

Feature Layer
clip_layer

包含用于剪切输入要素的面要素的数据集。

Feature Layer
out_feature_class

具有已裁剪要素的输出要素类。

Feature Class

代码示例

ClipLayer 示例(独立脚本)

以下 Python 脚本演示了如何使用 ClipLayer 函数。

#-------------------------------------------------------------------------------
# Name: ClipLayer.py
# Description: Clip USA Rivers to the extent of state boundaries.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/data/USA.gdb"

# Set local variables
clipFeatures = "USA_Rivers"
studyArea = "Nebraska_Boundary"
out = "NebraskaRivers"

# Run Clip Layer
arcpy.gapro.ClipLayer(clipFeatures, studyArea, out)