Clip

获得 Image Analyst 许可后可用。

描述

创建根据输入栅格数据集的范围或输入面要素类的形状裁剪的栅格对象。

讨论

根据定义的空间范围，使用 Clip 函数提取栅格数据集的一部分。例如，要处理 Landsat 影像中的一小块区域，可以将栅格裁剪至感兴趣区域。

该函数用于创建已从参照栅格对象中裁剪出的栅格对象。

栅格对象的引用栅格数据集是临时的。要将其设置为永久，可以调用栅格对象的 save 方法。

语法

Clip (in_raster, aoi)

参数	说明	数据类型
in_raster	输入栅格。	Raster
aoi	定义用于裁剪栅格的感兴趣区 (AOI) 或裁剪范围。支持的 AOI 选项包含 Raster、Extent 或 Polygon 几何。	Extent

返回值

数据类型	说明
Raster	输出裁剪栅格。

代码示例

裁剪示例 1

将国家土地覆被栅格数据集裁剪到单个州的范围。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input raster
in_raster = arcpy.Raster("USA_Landcover.tif")

# Clip the raster using a feature extent
clip_raster = arcpy.ia.Clip(in_raster, aoi = "C:\Data\California_State.shp")
clip_raster.save("California_Landcover.tif")

裁剪示例 2

使用面类裁剪栅格对象。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input raster
in_raster = arcpy.Raster("us_landcover.tif")

# Create a polygon geometry object using the array object
coordinates = [[-102.78838, 42.9953], [-104.0594, 43.8529], 
	[-104.0489, 45.942993], [-102.78838, 42.9953]]
array = arcpy.Array([arcpy.Point(x, y) for x, y in coordinates])
polygon_geometry=arcpy.Polygon(array, arcpy.SpatialReference(4326))

# Clip the raster using the polygon geometry
clip_raster = arcpy.ia.Clip(in_raster, aoi = polygon_geometry)
clip_raster.save("landcover_clipped_by_polygon_geometry.tif")