下载栅格 (数据管理)

摘要

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

使用情况

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

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

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

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

参数

标注说明数据类型
输入

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

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

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

Folder
查询定义
(可选)

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

SQL Expression
选择要素
(可选)

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

  • 当前显示范围 地图视图 - 范围基于活动地图或场景。 仅在存在活动地图时,才可使用此选项。
  • 绘制范围 构造直角并完成草图 - 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。
    注:

    环境对话框中不提供此选项。 只能在具有范围数据类型的工具参数中或工具对话框的环境选项卡中找到此选项。

    注:

    当选中从“编辑”选项卡启用和禁用编辑编辑选项时,必须在编辑功能区选项卡上启用编辑才能绘制范围。

  • 图层范围 Layer - 范围基于活动地图图层。 使用下拉列表选择可用图层,或使用所有图层中数据的范围选项获取所有活动地图图层(不包括底图)的组合范围。 仅在存在具有图层的活动地图时,才可使用此选项。

    每个地图图层具有以下选项:

    • 所有要素 全选 - 图层中所有要素的范围。
    • 选定要素Area from Selected Features - 图层中选定要素的范围。
    • 可见要素 Extent Indicator - 图层中可见要素的范围。
      注:

      选定要素 Area from Selected Features可见要素 Extent Indicator 选项中的范围仅适用于要素图层。

  • 浏览 浏览 - 范围基于现有数据集。
  • 剪贴板 粘贴 - 可在剪贴板中复制和粘贴范围。
    • 复制范围 复制 - 将范围坐标和坐标系复制到剪贴板。
    • 使用粘贴范围 粘贴 - 从剪贴板粘贴范围坐标和(可选)坐标系。 如果剪贴板值不包含坐标系,则范围将使用地图的坐标系。
    注:

    将使用与 ArcPy Extent 对象相同的格式和顺序从剪贴板中复制和粘贴范围坐标:x-min、y-min、x-max、y-max 和空间参考。

  • 重置范围 重置 - 将范围重置为默认值。
  • 手动输入坐标 - 坐标必须是数值,并且与活动地图的坐标系相匹配。
    警告:

    地图可能使用与输入的坐标不同的显示单位。 不支持使用主方向(N、S、E、W)。 在南纬和西经坐标中使用负号。

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

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

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

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

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

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

  • TIFF标记图像文件格式。这是默认设置。
  • BILEsri 波段按行交叉格式。
  • BSQEsri 波段顺序格式。
  • BIPEsri 波段按像元交叉格式。
  • BMP位图。
  • ENVIENVI DAT 文件。
  • IMAGINE ImageERDAS IMAGINE。
  • JPEG联合图像专家组。如果已选择,也可指定压缩质量。压缩质量的有效值范围是 0 到 100。
  • GIF图形交换格式。
  • JP2JPEG 2000。如果已选择,也可指定压缩质量。压缩质量的有效值范围是 0 到 100。
  • PNG可移植网络图形。
String
压缩方法
(可选)

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

  • NONE不会发生任何压缩。这是默认设置。
  • JPEG使用公共 JPEG 压缩算法的有损压缩。如果选择 JPEG,还可以指定压缩质量。压缩质量的有效值范围是 0 到 100。这种压缩方式可用于 JPEG 文件和 TIFF 文件。
  • LZW保留所有栅格像元值的无损压缩。
  • PACKBITS用于 TIFF 文件的 PackBits 压缩。
  • RLE用于 IMG 文件的游程编码。
  • CCITT_GROUP3用于 1 位数据的无损压缩。
  • CCITT_GROUP4用于 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")

环境

相关主题