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, {out_base_name}, {where_clause}, {format}, {nodata_value}, {clip_type}, {template_dataset}, {cell_size})
Parameter | Explanation | Data 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 |
out_base_name (Optional) | 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 |
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 |
format (Optional) | Choose a format for the downloaded raster datasets.
| 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.
| 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 Desktop Basic: No
- ArcGIS Desktop Standard: Yes
- ArcGIS Desktop Advanced: Yes