Export Mosaic Dataset Items (Data Management)

Summary

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

There are two common workflows that use this tool:

  • Export each item of a mosaic dataset to a new file. This allows you to have each processed item as its own stand-alone file. Ensure that you set the appropriate NoData value for the exported items so there are no black borders.
  • Export 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 items will be exported to the specified folder. Use the Query Definition parameter or interactively select specific records in the mosaic dataset 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

arcpy.management.ExportMosaicDatasetItems(in_mosaic_dataset, out_folder, {out_base_name}, {where_clause}, {format}, {nodata_value}, {clip_type}, {template_dataset}, {cell_size})
ParameterExplanationData Type
in_mosaic_dataset

The mosaic dataset that contains the images you want to export.

Mosaic Layer
out_folder

The folder where you want to save your images.

Folder
out_base_name
(Optional)

A prefix to name each item after it is copied. The prefix will be followed by the Object ID from the mosaic dataset footprints table.

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

String
where_clause
(Optional)

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

SQL Expression
format
(Optional)

Specifies the format for the output raster datasets.

  • TIFFTIFF format. This is the default.
  • Cloud Optimized GeoTIFFCloud Optimized GeoTIFF format.
  • BMPBMP format.
  • ENVIENVI DAT format.
  • Esri BILEsri BIL format.
  • Esri BIPEsri BIP format.
  • Esri BSQEsri BSQ format.
  • GIFGIF format.
  • GRIDEsri Grid format.
  • IMAGINE IMAGEERDAS IMAGINE format.
  • JP2JPEG 2000 format.
  • JPEGJPEG format.
  • PNGPNG format.
  • CRFCloud raster format.
  • MRFMeta raster format.
String
nodata_value
(Optional)

All the pixels with the specified value will be set to NoData in the output raster dataset.

It is recommended that you specify a NoData value if the output images will be clipped.

String
clip_type
(Optional)

Specifies the output extent of the raster datasets. If you choose an extent or feature class that covers an area larger than the raster data, the output will have the larger extent.

  • NONEThe output will not be clipped. This is the default.
  • EXTENTAn extent will be used to clip the output.
  • FEATURE_CLASSA feature class extent will be used to clip the output.
String
template_dataset
(Optional)

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

  • MAXOF—The maximum extent of all inputs will be used.
  • MINOF—The minimum area common to all inputs will be used.
  • DISPLAY—The extent is equal to the visible display.
  • Layer name—The extent of the specified layer will be used.
  • Extent object—The extent of the specified object will be used.
  • Space delimited string of coordinates—The extent of the specified string will be used. Coordinates are expressed in the order of x-min, y-min, x-max, y-max.
Extent
cell_size
(Optional)

The horizontal (x) and vertical (y) dimensions of the output cells.

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

Point

Derived Output

NameExplanationData Type
derived_out_folder

The updated output folder.

Folder

Code sample

ExportMosaicDatasetItems example 1 (Python window)

This is a Python sample for the ExportMosaicDatasetItems tool.

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 the ExportMosaicDatasetItems tool.

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

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes