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

摘要

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

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

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

使用情况

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

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

参数

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

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

Mosaic Layer
输出文件夹

想要保存影像的文件夹。

Folder
输出基本名称
(可选)

前缀命名被复制后的各项。前缀后跟镶嵌数据集覆盖区表中的 Object ID

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

String
查询定义
(可选)

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

SQL Expression
输出格式
(可选)

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

  • TIFFTIFF 格式。这是默认设置。
  • Cloud Optimized GeoTIFFCloud Optimized GeoTIFF 格式。
  • BMPBMP 格式。
  • ENVI DATENVI DAT 格式。
  • Esri BILEsri BIL 格式。
  • Esri BIPEsri BIP 格式。
  • Esri BSQEsri BSQ 格式。
  • GIFGIF 格式。
  • Esri GridEsri Grid 格式。
  • ERDAS IMAGINEERDAS IMAGINE 格式。
  • JPEG 2000JPEG 2000 格式。
  • JPEGJPEG 格式。
  • PNGPNG 格式。
  • 云栅格格式云栅格格式。
  • 元栅格格式元栅格格式。
String
NoData 值
(可选)

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

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

String
裁剪类型
(可选)

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

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

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

  • 默认 - 该范围将基于所有参与输入的最大范围设定。这是默认设置。
  • 当前显示范围 - 该范围与数据框或可见显示范围相等。如果没有活动地图,则该选项将不可用。
  • 如下面的指定 - 该范围将基于指定的最小和最大范围值。
  • 浏览 - 该范围将基于现有数据集。
Extent
像元大小
(可选)

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

如果未指定,将使用输入的空间分辨率。

Point

派生输出

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

更新的输出文件夹。

文件夹

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

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

Mosaic Layer
out_folder

想要保存影像的文件夹。

Folder
out_base_name
(可选)

前缀命名被复制后的各项。前缀后跟镶嵌数据集覆盖区表中的 Object ID

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

String
where_clause
(可选)

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

SQL Expression
format
(可选)

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

  • TIFFTIFF 格式。这是默认设置。
  • Cloud Optimized GeoTIFFCloud Optimized GeoTIFF 格式。
  • BMPBMP 格式。
  • ENVIENVI DAT 格式。
  • Esri BILEsri BIL 格式。
  • Esri BIPEsri BIP 格式。
  • Esri BSQEsri BSQ 格式。
  • GIFGIF 格式。
  • GRIDEsri Grid 格式。
  • IMAGINE IMAGEERDAS IMAGINE 格式。
  • JP2JPEG 2000 格式。
  • JPEGJPEG 格式。
  • PNGPNG 格式。
  • 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

派生输出

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