返回顶部

下载栅格 (数据管理)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

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

使用情况

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

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

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

  • 可以选择以与源相同的文件夹结构下载数据。

参数

对话框Python

标注说明数据类型
输入

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

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

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

Folder
查询定义
(可选)

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

SQL Expression
选择要素
(可选)

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

  • 当前显示范围 地图视图 - 范围基于活动地图或场景。
  • 绘制范围 构造直角并完成草图 - 范围将基于在地图或场景上绘制的矩形。
  • 图层范围 图层 - 范围基于活动地图图层。 选择可用图层或者使用所有图层中的数据范围选项。 每个地图图层具有以下选项：

    • 所有要素 全选 - 所有要素的范围。
    • 选定要素 基于选定要素的区域 - 选定要素的范围。
    • 可见要素 Extent Indicator - 可见要素的范围。

  • 浏览 浏览 - 范围将基于数据集。
  • 剪贴板 粘贴 - 可在剪贴板中复制和粘贴范围。
    • 复制范围 复制 - 将范围和坐标系复制到剪贴板。
    • 粘贴范围 粘贴 - 从剪贴板粘贴范围和坐标系。 如果剪贴板不包含坐标系，则范围将使用地图的坐标系。
  • 重置范围 重置 - 将范围重置为默认值。

当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。 地图可能使用与提供的坐标不同的显示单位。 在南纬和西经坐标中使用负号。

Extent
使用选择要素进行裁剪
(可选)

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

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

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

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

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

  • Tiff—标记图像文件格式。 这是默认设置。
  • Bil—Esri 波段按行交叉格式。
  • Bsq—Esri 波段顺序格式。
  • Bip—Esri 波段按像元交叉格式。
  • Bmp—位图。
  • ENVI Dat—ENVI DAT 文件。
  • Imagine 图像—ERDAS IMAGINE。
  • Jpeg—联合图像专家组。 如果已选择，也可指定压缩质量。 压缩质量的有效值范围是 0 到 100。
  • Gif—图形交换格式。
  • Jp2—JPEG 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

派生输出

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

更新的输出文件夹。

Folder

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—将基于选择要素的几何对文件进行裁剪。
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

更新的输出文件夹。

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: 是

相关主题

  • 栅格工具集概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息