裁剪 (Data Management)

许可等级:BasicStandardAdvanced

摘要

创建包括栅格数据集、镶嵌数据集或影像服务图层在内的栅格空间子集。

插图

Clip illustration

用法

语法

Clip_management (in_raster, rectangle, out_raster, {in_template_dataset}, {nodata_value}, {clipping_geometry})
参数说明数据类型
in_raster

输入栅格数据集。

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
rectangle

用于定义裁剪所需的最小外接矩形的四个坐标按以下顺序定义:X 最小值、Y 最小值、X 最大值和 Y 最大值。

如果指定的裁剪范围没有与输入栅格数据集对齐,则“裁剪”工具可确保使用适当的对齐。这可能使输出的实际范围与此工具中指定的范围略有不同。

Envelope
out_raster

输出栅格数据集。确保输出格式可以支持适当的像素深度。

以文件格式存储栅格数据集时,需要指定文件扩展名,具体如下:

  • .bil—Esri BIL
  • .bip—Esri BIP
  • .bmp—BMP
  • .bsq—Esri BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • 无扩展名 Esri Grid

以地理数据库形式存储栅格数据集时,不应向栅格数据集的名称添加文件扩展名。

将栅格数据集存储到 JPEG 文件、JPEG 2000 文件、TIFF 文件或地理数据库时,可以指定压缩类型和压缩质量。

Raster Dataset
in_template_dataset
(可选)

可以将现有的栅格或矢量图层作为裁剪范围使用。该裁剪输出包括了与最小外接矩形相交的所有像素。

将某要素类作为输出范围并且要基于面要素进行栅格裁剪时,请使用 clipping_geometry 选项。选中此项可以提高输出的像素深度。因此,需要确保输出格式可以支持适当的像素深度。

Raster Layer; Feature Layer
nodata_value
(可选)

具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。

String
clipping_geometry
(可选)

如果使用要素类作为输出范围,则可以通过该要素类的范围或面周长来裁剪栅格。

  • NONE基于要素类的最小外接矩形对栅格数据集进行裁剪。
  • ClippingGeometry基于面形状的周长对栅格数据集进行裁剪。

使用裁剪几何时,可能提高输出的像素深度。因此,需要确保输出格式可以支持适当的像素深度。

Boolean

代码实例

裁剪示例 1(Python 窗口)

这是“裁剪”工具的 Python 示例。

import arcpy
arcpy.Clip_management("c:/data/image.tif","1952602 294196 1953546 296176",
                      "c:/data/clip.gdb/clip01", "#", "#", "NONE")
裁剪示例 2(独立脚本)

这是“裁剪”工具的 Python 脚本的示例。

##====================================
##Clip
##Usage: Clip_management in_raster rectangle out_raster {in_template_dataset} {nodata_value} {NONE | ClippingGeometry}

try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"
    
    ##Clip Raster Dataset by known extent - Left Bottom Right Top
    arcpy.Clip_management("image.tif","1952602.23 294196.279 1953546.23 296176.279","clip.gdb/clip", "#", "#", "NONE")
    
    ##Clip Raster Dataset with feature geometry
    arcpy.Clip_management("image.tif", "#", "clip.tif","feature.shp", "0", "ClippingGeometry")
except:
    print "Clip example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013