导出镶嵌数据集项目 (数据管理)

摘要

将镶嵌数据集中处理过的影像副本以栅格文件格式保存到指定的文件夹。

有两种常规工作流使用该工具:

  • 将选择的各镶嵌数据集项导出到新文件。 这样便可将经过处理的各项保留为独立文件。 必须为导出的项目设置了相应的 NoData 值,以防出现深色边框。
  • 基于感兴趣的区域导出时间序列镶嵌数据集内的每个所选影像。 这样您便可只导出各个时间段内感兴趣的区域。

使用情况

  • 默认情况下,所有项目将导出至指定文件夹。 使用查询定义参数或以交互的方式选择镶嵌数据集中的特定记录以导出一部分影像。

  • 导出的影像将应用函数链中的所有处理流程。 只应用了项级别的函数链;忽略了镶嵌数据集级别的函数链。 此工具不导出原始的源影像。

参数

标注说明数据类型
镶嵌数据集

包含要导出的影像的镶嵌数据集。

Mosaic Layer
输出文件夹

将保存影像的文件夹。

Folder
输出基本名称
(可选)

复制后添加到每个项目名称的前缀。 前缀后跟镶嵌数据集覆盖区表中的 Object ID 值。

如果未设置基本名称,则将使用镶嵌数据集项的 Name 字段中的文本。

String
查询定义
(可选)

用来在镶嵌数据集中保存选定影像的 SQL 表达式。

SQL Expression
输出格式
(可选)

指定输出栅格数据集的格式。

  • TIFF将使用 TIFF 格式。 这是默认设置。
  • Cloud Optimized GeoTIFF使用 Cloud Optimized GeoTIFF 格式。
  • BMP使用 BMP 格式。
  • ENVI DAT使用 ENVI DAT 格式。
  • Esri BIL使用 Esri BIL 格式。
  • Esri BIP使用 Esri BIP 格式。
  • Esri BSQ使用 Esri BSQ 格式。
  • GIF将使用图形交换格式 (GIF)。
  • Esri 格网将使用 Esri Grid 栅格数据集格式。
  • ERDAS IMAGINE将使用 ERDAS Imagine 格式。
  • JPEG 2000使用 JPEG 2000 格式。
  • JPEG将使用 JPEG 格式。
  • PNG将使用 PNG 格式。
  • 云栅格格式将使用云栅格格式。
  • 元栅格格式将使用元栅格格式。
String
NoData 值
(可选)

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

如果将裁剪输出影像,建议指定 NoData 值。

String
裁剪类型
(可选)

指定栅格数据集的处理范围。 如果选择的范围或要素类涵盖的区域大于栅格数据,则输出将具有更大的范围。

  • 无裁剪将不会裁剪输出。 这是默认设置。
  • 裁剪至范围将使用范围裁剪输出。
  • 裁剪至要素类将使用要素类范围裁剪输出。
String
裁剪模板
(可选)

将用于限制范围的要素类或边界框。

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

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

    注:

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

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

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

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

      选定要素 基于选定要素的区域可见要素 Extent Indicator 选项中的范围仅适用于要素图层。

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

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

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

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

Extent
像元大小
(可选)

输出像元的水平 (x) 和垂直 (y) 尺寸。

如果未指定像元大小,则将使用输入的空间分辨率。

Point
将影像导出到影像空间
(可选)

指定将栅格项目导出到地图空间还是影像空间。

  • 未选中 - 栅格项目将在地图空间中导出。 这是默认设置。
  • 选中 - 栅格项目将在影像空间中导出。

Boolean
消除图像变形
(可选)

指定是否将从影像空间的导出栅格中移除镜头变形。

  • 未选中 - 不会从影像空间的导出栅格中移除镜头变形。 这是默认设置。
  • 选中 - 将从影像空间的导出栅格中移除镜头变形。

Boolean

派生输出

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

更新的输出文件夹。

Folder

arcpy.management.ExportMosaicDatasetItems(in_mosaic_dataset, out_folder, {out_base_name}, {where_clause}, {format}, {nodata_value}, {clip_type}, {template_dataset}, {cell_size}, {image_space}, {remove_distortion})
名称说明数据类型
in_mosaic_dataset

包含要导出的影像的镶嵌数据集。

Mosaic Layer
out_folder

将保存影像的文件夹。

Folder
out_base_name
(可选)

复制后添加到每个项目名称的前缀。 前缀后跟镶嵌数据集覆盖区表中的 Object ID 值。

如果未设置基本名称,则将使用镶嵌数据集项的 Name 字段中的文本。

String
where_clause
(可选)

用来在镶嵌数据集中保存选定影像的 SQL 表达式。 有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
format
(可选)

指定输出栅格数据集的格式。

  • TIFF将使用 TIFF 格式。 这是默认设置。
  • Cloud Optimized GeoTIFF使用 Cloud Optimized GeoTIFF 格式。
  • BMP使用 BMP 格式。
  • ENVI使用 ENVI DAT 格式。
  • Esri BIL使用 Esri BIL 格式。
  • Esri BIP使用 Esri BIP 格式。
  • Esri BSQ使用 Esri BSQ 格式。
  • GIF将使用图形交换格式 (GIF)。
  • GRID将使用 Esri Grid 栅格数据集格式。
  • IMAGINE IMAGE将使用 ERDAS Imagine 格式。
  • JP2使用 JPEG 2000 格式。
  • JPEG将使用 JPEG 格式。
  • PNG将使用 PNG 格式。
  • CRF将使用云栅格格式。
  • MRF将使用元栅格格式。
String
nodata_value
(可选)

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

如果将裁剪输出影像,建议指定 NoData 值。

String
clip_type
(可选)

指定栅格数据集的处理范围。 如果选择的范围或要素类涵盖的区域大于栅格数据,则输出将具有更大的范围。

  • NONE将不会裁剪输出。 这是默认设置。
  • EXTENT将使用范围裁剪输出。
  • FEATURE_CLASS将使用要素类范围裁剪输出。
String
template_dataset
(可选)

将用于限制范围的要素类或边界框。

  • MAXOF - 将使用的所有输入的最大范围。
  • MINOF - 将使用的所有输入共用的最小范围。
  • DISPLAY - 范围与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent
cell_size
(可选)

输出像元的水平 (x) 和垂直 (y) 尺寸。

如果未指定像元大小,则将使用输入的空间分辨率。

Point
image_space
(可选)

指定将栅格项目导出到地图空间还是影像空间。

  • MAPSPACE栅格项目将在地图空间中导出。 这是默认设置。
  • IMAGESPACE栅格项目将在影像空间中导出。
Boolean
remove_distortion
(可选)

指定是否将从影像空间的导出栅格中移除镜头变形。

  • REMOVED将从影像空间的导出栅格中移除镜头变形。
  • NOTREMOVE不会从影像空间的导出栅格中移除镜头变形。 这是默认设置。
Boolean

派生输出

名称说明数据类型
derived_out_folder

更新的输出文件夹。

Folder

代码示例

ExportMosaicDatasetItems 示例 1(Python 窗口)

这是 ExportMosaicDatasetItems 函数的 Python 示例。

import arcpy
arcpy.ExportMosaicDatasetItems_management(
     "c:/workspace/exportmditems.gdb/export_all_items", 
     "c:/workspace/export_all_items_out", 
     "allitems", "", "TIFF", "", "NONE", "", "")
ExportMosaicDatasetItems 示例 2(独立脚本)

这是 ExportMosaicDatasetItems 函数的 Python 脚本。

#Export Mosaic Dataset items
                                                                       
import arcpy
arcpy.env.workspace = "c:/workspace"
    
#export mosaic dataset items using feature class as clipping extent
imdname = "exportmditem.gdb/exportmd" 
outfolder = "c:/workspace/outfolder"
basename = "Landsat8"
query = "OBJECTID = 1"
out_format = "TIFF"
nodata_value = "#"
cliptype = "FEATURE_CLASS"
clip_featureclass = "c:/workspace/featureclassdb.gdb/clip_FC"
cell_size = "#"

arcpy.ExportMosaicDatasetItems_management(imdname, outfolder, basename, 
     query, out_format, nodata_value, cliptype, clip_featureclass, cell_size)

许可信息

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