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

摘要

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

以下两种常规工作流将使用此工具：

• 将选择的各镶嵌数据集项导出到新文件。 这样便可将经过处理的各项保留为独立文件。 必须为导出的项目设置了相应的 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
像元大小 (可选)	输出像元的水平 (x) 和垂直 (y) 尺寸。 如果未提供像元大小，则将使用输入的空间分辨率。	Point
将影像导出到影像空间 (可选)	指定将栅格项目导出到地图空间还是影像空间。 未选中 - 栅格项目将在地图空间中导出。 这是默认设置。 选中 - 栅格项目将在影像空间中导出。	Boolean
消除图像变形 (可选)	指定是否将从影像空间的导出栅格中移除镜头变形。 未选中 - 不会从影像空间的导出栅格中移除镜头变形。 这是默认设置。 选中 - 将从影像空间的导出栅格中移除镜头变形。	Boolean
波段方法 (可选)	指定将用于选择波段的方法。 当选中将影像导出到影像空间参数时，此参数处于启用状态。 所有波段—将导出所有波段。 这是默认设置。 波段 ID—将基于波段 ID 选择参数值导出波段。 波段名称—将基于波段名称选择参数值导出波段。	String
波段名称选择 (可选)	将从输入镶嵌数据集中导出的波段的名称。 当波段方法参数设置为波段名称时，此参数处于启用状态。	Value Table
波段 ID 选择 (可选)	将从输入镶嵌数据集中导出的波段的 ID 编号。 当波段方法参数设置为波段 ID 时，此参数处于启用状态。	Value Table

派生输出

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

Python

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}, {band_method}, {band_name_selection}, {band_id_selection})

名称	说明	数据类型
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
band_method (可选)	指定将用于选择波段的方法。 当将 image_space 参数设置为 IMAGESPACE 时，此参数处于启用状态。 ALL_BANDS—将导出所有波段。 这是默认设置。 BAND_IDS—将基于 band_id_selection 参数值导出波段。 BAND_NAMES—将基于 band_name_selection 参数值导出波段。	String
band_name_selection [band_name_selection,...] (可选)	将从输入镶嵌数据集中导出的波段的名称。 当将 band_method 参数设置为 BAND_NAMES 时，此参数处于启用状态。	Value Table
band_id_selection [band_id_selection,...] (可选)	将从输入镶嵌数据集中导出的波段的 ID 编号。 当将 band_method 参数设置为 BAND_IDS 时，此参数处于启用状态。	Value Table

派生输出

名称	说明	数据类型
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)

ExportMosaicDatasetItems 示例 3（Python 窗口）

这是使用 band_id_selection 参数以选择波段的 ExportMosaicDatasetItems 函数的 Python 脚本示例。

import arcpy
 
arcpy.management.ExportMosaicDatasetItems(in_mosaic_dataset=r"c:\workspace\exportmditems.gdb\ImageCollection", out_folder=r"C:\workspace\ExportMDItem", out_base_name="Band_ID", where_clause="", format="TIFF", nodata_value="", clip_type="NONE", template_dataset="DEFAULT", cell_size=None, image_space="IMAGESPACE", remove_distortion="REMOVED", band_method="BAND_IDS", band_name_selection= None, band_id_selection="1;2;3;4")

环境

压缩, 地理变换, NoData, 输出坐标系, 并行处理因子, 金字塔, 栅格统计, 重采样方法, 捕捉栅格, 切片大小

许可信息

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