下载栅格 (数据管理)

摘要

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

使用情况

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

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

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

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

参数

标注说明数据类型
输入

要下载的影像服务或镶嵌数据集。

Image Service; Mosaic Layer; Raster Layer; String
输出文件夹

影像服务或镶嵌数据集的目标。

Folder
查询定义
(可选)

SQL 表达式,用于将下载限制到满足表达式的栅格数据集。

SQL Expression
选择要素
(可选)

将下载限制到要素类范围或边界框。将下载与该范围相交的所有栅格数据集。

  • 默认 - 该范围将基于所有参与输入的最大范围设定。这是默认设置。
  • 当前显示范围 - 该范围与数据框或可见显示范围相等。如果没有活动地图,则该选项将不可用。
  • 如下面的指定 - 该范围将基于指定的最小和最大范围值。
  • 浏览 - 该范围将基于现有数据集。
Extent
使用选择要素进行裁剪
(可选)

指定是否想根据要素的几何来裁剪下载的图像。这样就会裁剪与裁剪几何相交的任何栅格,然后将其下载。当感兴趣区域不是矩形时,这个选项非常有用。在裁剪已下载的影像时,需要指定裁剪影像的输出格式。

  • 取消选中 - 基于指定的最小外接矩形对文件进行裁剪。这是默认设置。
  • 选中 - 基于选择要素的几何对文件进行裁剪。
Boolean
转换栅格
(可选)

选择始终将栅格转换为指定格式,还是仅在需要时进行转换。

  • 取消选中 - 不会将栅格数据集转换为新的格式。
  • 选中 - 将下载的栅格数据集转换为其他格式。如果使用选择要素限制范围,您将需要在输出格式参数中指定格式。
Boolean
输出格式
(可选)

为已下载的栅格数据集选择输出格式。

  • Tiff标记图像文件格式。这是默认设置。
  • BilEsri 波段按行交叉格式。
  • BsqEsri 波段顺序格式。
  • BipEsri 波段按像元交叉格式。
  • Bmp位图。
  • ENVI DatENVI DAT 文件。
  • Imagine 图像ERDAS IMAGINE。
  • Jpeg联合图像专家组。如果已选择,也可指定压缩质量。压缩质量的有效值范围是 0 到 100。
  • Gif图形交换格式。
  • Jp2JPEG 2000。如果已选择,也可指定压缩质量。压缩质量的有效值范围是 0 到 100。
  • Png可移植网络图形。
String
压缩方法
(可选)

选择使用指定输出格式的压缩方法。

  • 不会发生任何压缩。这是默认设置。
  • Jpeg使用公共 JPEG 压缩算法的有损压缩。如果选择 JPEG,还可以指定压缩质量。压缩质量的有效值范围是 0 到 100。这种压缩方式可用于 JPEG 文件和 TIFF 文件。
  • Lzw保留所有栅格像元值的无损压缩。
  • Packbits用于 TIFF 文件的 PackBits 压缩。
  • Rle用于 IMG 文件的游程编码。
  • Ccitt Group 3用于 1 位数据的无损压缩。
  • Ccitt Group 4用于 1 位数据的无损压缩。
  • Ccitt 1D用于 1 位数据的无损压缩。
String
压缩质量
(可选)

设置一个 1 到 100 之间的值。值越高则图像质量越好,但压缩程度也越低。

Long
维护文件夹结构
(可选)

确定所下载栅格的文件夹结构。

  • 选中 - 复制用于存储源栅格数据集的层次文件夹结构。
  • 取消选中 - 栅格数据集将下载到输出文件夹中作为平面文件夹结构

Boolean

派生输出

标注说明数据类型
更新后的文件夹

更新的输出文件夹。

文件夹

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标记图像文件格式。这是默认设置。
  • BILEsri 波段按行交叉格式。
  • BSQEsri 波段顺序格式。
  • BIPEsri 波段按像元交叉格式。
  • BMP位图。
  • ENVIENVI DAT 文件。
  • IMAGINE ImageERDAS IMAGINE。
  • JPEG联合图像专家组。如果已选择,也可指定压缩质量。压缩质量的有效值范围是 0 到 100。
  • GIF图形交换格式。
  • JP2JPEG 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: 是

相关主题