Help

Export Mosaic Dataset Items

Summary

Saves a copy of your processed images within a mosaic dataset to a specified folder and raster file format.

There are two common workflows that use this tool:

  • Exporting each processed item of a mosaic dataset to a new file. This allows you to have each processed item as its own stand-alone file. Make sure that you set the appropriate NoData value for the exported items so there are no black borders.
  • Exporting each image within a time series mosaic dataset, based on an area of interest. This allows you to have only the area of interest from each of the time slices.

Usage

  • By default, all the items will be exported to the specified folder. You can make a query or selection if you only want to export a subset of the images.

  • The images will be exported with all the processing from the function chains applied. Only the function chains at the item level are applied; function chains at the Mosaic Dataset level are ignored. This tool does not export the raw source images.

Syntax

ExportMosaicDatasetItems_management (in_mosaic_dataset, out_folder, {where_clause}, {out_base_name}, {format}, {nodata_value}, {clip_type}, {template_dataset}, {cell_size})
ParameterExplanationData Type
in_mosaic_dataset

The mosaic dataset that has the images you want to save.

Mosaic Layer
out_folder

The folder where you want to save your images.

Folder
where_clause
(Optional)

An SQL expression to save selected images in the mosaic dataset. For more information on SQL syntax, see SQL reference for query expressions used in ArcGIS.

SQL Expression
out_base_name
(Optional)

Choose a prefix to name each item after it is copied. The prefix will be followed by the Object ID.

If no base name is set, the text in the Name field of the mosaic dataset item will be used.

String
format
(Optional)

Choose a format for the downloaded raster datasets.

  • TIFF —Tagged Image File Format. This is the default.
  • BMP —Microsoft Bitmap.
  • ENVI —ENVI DAT.
  • Esri BIL —Esri Band Interleaved by Line.
  • Esri BIP —Esri Band Interleaved by Pixel.
  • Esri BSQ —Esri Band Sequential.
  • GIF —Graphic Interchange Format.
  • GRID —Esri Grid.
  • IMAGINE IMAGE —ERDAS IMAGINE.
  • JP2 —JPEG 2000.
  • JPEG —Joint Photographic Experts Group.
  • PNG —Portable Network Graphics.
String
nodata_value
(Optional)

Set a value for pixels to be considered as NoData.

If you choose to clip your output data, it is recommended that you specify a NoData value.

String
clip_type
(Optional)

Limit the extent of your raster dataset before you clip it. If you choose an extent or feature class that covers a larger area than your data, the output will have the larger extent.

  • NONE —Do not clip. This is the default.
  • EXTENT —Specify an extent to clip to.
  • FEATURE_CLASS —Specify a feature class to clip to.
String
template_dataset
(Optional)

Specify a feature class or a bounding box to limit the extent.

Extent
cell_size
(Optional)

Define the spatial resolution by specifying the horizontal (x) and vertical (y) dimensions of the output cells.

If not specified, the spatial resolution of the input will be used.

Point

Code sample

ExportMosaicDatasetItems example 1 (Python window)

This is a Python sample for ExportMosaicDatasetItems.

import arcpy
arcpy.ExportMosaicDatasetItems_management(
     "c:/workspace/exportmditems.gdb/export_all_items", 
     "c:/workspace/export_all_items_out", 
     "allitems", "", "TIFF", "", "NONE", "", "")
ExportMosaicDatasetItems example 2 (stand-alone script)

This is a Python script sample for ExportMosaicDatasetItems.

#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)

Environments

Licensing information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes