Export Mosaic Dataset Items (Data Management)

Summary

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

There are two common workflows that use this tool:

• Export each selected item of a mosaic dataset to a new file. This allows you to have each processed item as a stand-alone file. You must set the appropriate NoData value for the exported items so there are no dark borders.
• Export each selected image within a time series mosaic dataset based on an area of interest. This allows you to only export the area of interest from each time slice.

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.

Parameters

Dialog

Label	Explanation	Data Type
Mosaic Dataset	The mosaic dataset that contains the images to be exported.	Mosaic Layer
Output Folder	The folder where the images will be saved.	Folder
Output Base Name (Optional)	A prefix to add to the name of each item after it is copied. The prefix will be followed by the Object ID value 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
Query Definition (Optional)	An SQL expression that will be used to save selected images in the mosaic dataset.	SQL Expression
Output Format (Optional)	Specifies the format that will be used for the output raster datasets. TIFF—TIFF format will be used. This is the default. Cloud Optimized GeoTIFF—Cloud Optimized GeoTIFF format will be used. BMP—BMP format will be used. ENVI DAT—ENVI DAT format will be used. Esri BIL—Esri BIL format will be used. Esri BIP—Esri BIP format will be used. Esri BSQ—Esri BSQ format will be used. GIF—GIF format will be used. Esri Grid—Esri Grid format will be used. ERDAS IMAGINE—ERDAS IMAGINE format will be used. JPEG 2000—JPEG 2000 format will be used. JPEG—JPEG format will be used. PNG—PNG format will be used. Cloud raster format—Cloud raster format will be used. Meta raster format—Meta raster format will be used.	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. No clipping—The output will not be clipped. This is the default. Clip to extent—An extent will be used to clip the output. Clip to feature class—A feature class extent will be used to clip the output.	String
Clipping Template (Optional)	The feature class or bounding box that will be used to limit the extent. Current Display Extent —The extent will be based on the active map or scene. This option is only available when there is an active map. Draw Extent —The extent will be based on a rectangle drawn on the map or scene. This option will create a feature class in the project geodatabase and add a layer to the map. The feature class will have the same coordinate system as the map. Note: This option is not available in the Environments dialog box. It is only available from a tool parameter with an extent data type or from the Environments tab on a tool dialog box. Note: When the Enable and disable editing from the Edit tab editing option is checked, you must enable editing on the Edit ribbon tab to draw the extent. Extent of a Layer —The extent will be based on an active map layer. Use the drop-down list to choose an available layer or use the Extent of data in all layers option to get the combined extent of all active map layers, excluding the basemap. This option is only available when there is an active map with layers. Each map layer has the following options: All Features —The extent of all features in the layer. Selected Features —The extent of the selected features in the layer. Visible Features —The extent of the visible features in the layer. Note: The extents from the Selected Features and Visible Features options are only available for feature layers. Browse —The extent will be based on an existing dataset. Clipboard —The extent can be copied to and pasted from the clipboard. Copy Extent —Copies the extent coordinates and coordinate system to the clipboard. Use Paste Extent —Pastes the extent coordinates and, optionally, the coordinate system from the clipboard. If the clipboard values do not include a coordinate system, the extent will use the map’s coordinate system. Note: The extent coordinates are copied to and pasted from the clipboard using the same formatting and order as the ArcPy Extent object: x-min, y-min, x-max, y-max, and the spatial reference. Reset Extent —The extent will be reset to the default value. Manually entered coordinates—The coordinates must be numeric values and in the active map's coordinate system. Caution: The map may use different display units than the entered coordinates. The use of a cardinal direction (N, S, E, W) is not supported. Use a negative value sign for south and west coordinates.	Extent
Cell Size (Optional)	The horizontal (x) and vertical (y) dimensions of the output cells. If the cell size is not specified, the spatial resolution of the input will be used.	Point
Export images to image space (Optional)	Specifies whether raster items will be exported in map space or image space. Unchecked—Raster items will be exported in map space. This is the default. Checked—Raster items will be exported in image space.	Boolean
Remove image distortions (Optional)	Specifies whether lens distortion will be removed from the exported raster in image space. Unchecked—Lens distortion will not be removed from the exported raster in image space. This is the default. Checked—Lens distortion will be removed from the exported the raster in image space.	Boolean

Derived Output

Label	Explanation	Data Type
Updated Output Folder	The updated output folder.	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})

Name	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset that contains the images to be exported.	Mosaic Layer
out_folder	The folder where the images will be saved.	Folder
out_base_name (Optional)	A prefix to add to the name of each item after it is copied. The prefix will be followed by the Object ID value 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 that will be used to save selected images in the mosaic dataset. For more information about SQL syntax, see SQL reference for query expressions used in ArcGIS.	SQL Expression
format (Optional)	Specifies the format that will be used for the output raster datasets. TIFF—TIFF format will be used. This is the default. Cloud Optimized GeoTIFF—Cloud Optimized GeoTIFF format will be used. BMP—BMP format will be used. ENVI—ENVI DAT format will be used. Esri BIL—Esri BIL format will be used. Esri BIP—Esri BIP format will be used. Esri BSQ—Esri BSQ format will be used. GIF—GIF format will be used. GRID—Esri Grid format will be used. IMAGINE IMAGE—ERDAS IMAGINE format will be used. JP2—JPEG 2000 format will be used. JPEG—JPEG format will be used. PNG—PNG format will be used. CRF—Cloud raster format will be used. MRF—Meta raster format will be used.	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. NONE—The output will not be clipped. This is the default. EXTENT—An extent will be used to clip the output. FEATURE_CLASS—A feature class extent will be used to clip the output.	String
template_dataset (Optional)	The feature class or bounding box that will be used 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 the cell size is not specified, the spatial resolution of the input will be used.	Point
image_space (Optional)	Specifies whether raster items will be exported in map space or image space. MAPSPACE—Raster items will be exported in map space. This is the default. IMAGESPACE—Raster items will be exported in image space.	Boolean
remove_distortion (Optional)	Specifies whether lens distortion will be removed from the exported raster in image space. REMOVED—Lens distortion will be removed from the exported raster in image space. NOTREMOVE—Lens distortion will not be removed from the exported raster in image space. This is the default.	Boolean

Derived Output

Name	Explanation	Data Type
derived_out_folder	The updated output folder.	Folder

Code sample

ExportMosaicDatasetItems example 1 (Python window)

This is a Python sample for the ExportMosaicDatasetItems function.

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 function.

#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

Compression, Geographic Transformations, NoData, Output Coordinate System, Parallel Processing Factor, Pyramid, Raster Statistics, Resampling Method, Snap Raster, Tile Size