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})
Parameter | Explanation | Data 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 query expressions used in ArcGIS. | SQL Expression |
format (Optional) | Specifies the format for the output raster datasets.
| 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.
| String |
template_dataset (Optional) | A feature class or a bounding box to limit the extent. | 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
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 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)
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes