下载栅格 (数据管理)

描述

下载影像服务或镶嵌数据集中的源文件。

使用方法

• 除非将下载的栅格数据集转换为另一格式，否则它们为源文件。可强制执行格式转换，或仅在需要时才进行转换。如果进行了裁剪或无法将源文件下载为栅格，则将转换下载后的文件。

• 可将选中栅格或 LAS 文件以原始文件的格式从影像服务或镶嵌数据集中下载到指定文件夹。

• 如果指定了裁剪范围，则将裁剪与裁剪范围相交的栅格，然后将其转换为指定格式。

• 可选择下载同一文件夹结构中的数据作为源。

语法

arcpy.management.DownloadRasters(in_image_service, out_folder, {where_clause}, {selection_feature}, {clipping}, {convert_rasters}, {format}, {compression_method}, {compression_quality}, {MAINTAIN_FOLDER})

参数	说明	数据类型
in_image_service	要下载的影像服务或镶嵌数据集。	Image Service; Mosaic Layer; Raster Layer; String
out_folder	影像服务或镶嵌数据集的目标。	Folder
where_clause （可选）	SQL 表达式，用于将下载限制到满足表达式的栅格数据集。	SQL Expression
selection_feature （可选）	将下载限制到要素类范围或边界框。将下载与该范围相交的所有栅格数据集。 MAXOF - 将使用所有输入的最大范围。 MINOF - 将使用所有输入共有的最小区域。 DISPLAY - 该范围与可见显示范围相等。 图层名称 - 将使用指定图层的范围。 Extent 对象 - 将使用指定对象的范围。 以空格分隔的坐标字符串 - 将使用指定字符串的范围。坐标以 x-min，y-min，x-max，y-max 的顺序表示。	Extent
clipping （可选）	指定是否想根据要素的几何来裁剪下载的图像。这样就会裁剪与裁剪几何相交的任何栅格，然后将其下载。当感兴趣区域不是矩形时，这个选项非常有用。在裁剪已下载的影像时，需要指定裁剪影像的输出格式。 NO_CLIPPING —基于指定的最小外接矩形对文件进行裁剪。这是默认设置。 CLIPPING —基于 selection_feature 的几何对文件进行裁剪。	Boolean
convert_rasters （可选）	选择始终将栅格转换为指定格式，还是仅在需要时进行转换。 CONVERT_AS_REQUIRED —不会将栅格数据集转换为新的格式。 ALWAYS_CONVERT —将下载的栅格数据集转换为其他格式。如果使用 selection_feature 限制范围，您将需要在 format 参数中指定格式。	Boolean
format （可选）	为已下载的栅格数据集选择输出格式。 TIFF —标记图像文件格式。这是默认设置。 BIL —Esri 波段按行交叉格式。 BSQ —Esri 波段顺序格式。 BIP —Esri 波段按像元交叉格式。 BMP —位图。 ENVI —ENVI DAT 文件。 IMAGINE Image —ERDAS IMAGINE。 JPEG —联合图像专家组。如果已选择，也可指定压缩质量。压缩质量的有效值范围是 0 到 100。 GIF —图形交换格式。 JP2 —JPEG 2000。如果已选择，也可指定压缩质量。压缩质量的有效值范围是 0 到 100。 PNG —可移植网络图形。	String
compression_method （可选）	选择使用指定输出格式的压缩方法。 NONE —不会发生任何压缩。这是默认设置。 JPEG —使用公共 JPEG 压缩算法的有损压缩。如果选择 JPEG，还可以指定压缩质量。压缩质量的有效值范围是 0 到 100。这种压缩方式可用于 JPEG 文件和 TIFF 文件。 LZW —保留所有栅格像元值的无损压缩。 PACKBITS —用于 TIFF 文件的 PackBits 压缩。 RLE —用于 IMG 文件的游程编码。 CCITT_GROUP3 —用于 1 位数据的无损压缩。 CCITT_GROUP4 —用于 1 位数据的无损压缩。 CCITT_1D —用于 1 位数据的无损压缩。	String
compression_quality （可选）	设置一个 1 到 100 之间的值。值越高则图像质量越好，但压缩程度也越低。	Long
MAINTAIN_FOLDER （可选）	确定所下载栅格的文件夹结构。 MAINTAIN_FOLDER —复制用于存储源栅格数据集的层次文件夹结构。 NO_MAINTAIN_FOLDER —栅格数据集将下载到 out_folder 中作为平面文件夹结构。	Boolean

派生输出

名称	说明	数据类型
derived_out_folder	更新的输出文件夹。	文件夹

代码示例

DownloadRasters 示例 1（Python 窗口）

这是 DownloadRasters 工具的 Python 示例。

import arcpy
DownloadRasters_management(
     "http://srv/arcgis/services/Ext/MDpan/ImageServer?", "c:/dload/", 
     "AcquisitionDate = date '1999-08-18'", "", 
     "c:/workspace/clippingfeat.shp", "TIFF", "JPEG", "75", 
     "MAINTAIN_FOLDER", "CONVERT_AS_REQUIRED")

DownloadRasters 示例 2（独立脚本）

这是 DownloadRasters 工具的 Python 脚本示例。

##Download Rasters from image services URL
##Maintain the original sensor data folder structure

import arcpy
arcpy.env.workspace = r"\\myworkstation\Workspace\downloadras"
    
arcpy.DownloadRasters_management(
     "http://serv1/arcgis/services/Ext/MD_LS_pan/ImageServer?",
     "downloadFolder", "AcquisitionDate = date '1999-08-18 00:00:00'",
     "", "", "", "", "", "MAINTAIN_FOLDER")

环境

范围

许可信息

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