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

摘要

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

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

  • 将镶嵌数据集的每个项目导出至新文件。 这样便可将经过处理的各项保留为独立文件。 必须为导出的项目设置了相应的 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

派生输出

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

更新的输出文件夹。

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

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

Mosaic Layer
out_folder

将保存影像的文件夹。

Folder
out_base_name
(可选)

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

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

String
where_clause
(可选)

用来在镶嵌数据集中保存选定影像的 SQL 表达式。 有关 SQL 语法的详细信息,请参阅在查询表达式中使用的元素的 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

派生输出

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