Merge Mosaic Dataset Items (Data Management)
Summary
Merges together multiple mosaic dataset items.
Usage
Selections and queries should be used to choose the mosaic dataset items to merge. If a block field is also specified, the tool will take the results of the selection and merge all the similar block fields into separate rows.
The default number of maximum allowed items per merge is 1,000. If the maximum is exceeded, the tool will insert additional merged items for the selection or query. For example, if 2,000 items are selected, the tool will create two merged items.
Syntax
| Parameter | Explanation | Data Type |
in_mosaic_dataset |
The path and name of the mosaic dataset. | Image Service; Mosaic Layer; String |
where_clause (Optional) |
You can use SQL to define which mosaic dataset items will be merged. | SQL Expression |
block_field (Optional) | If a block name field does not already exist within the metadata, you can choose a field within the mosaic dataset attribute table to use as a block field. Fields that have the same value in their Block Field will be merged into the same row. Only date, numeric, and string fields can be specified as Block Fields. You can specify both a where_clause and a block_field, in which case only the rows that match the query and whose block field values match will be merged. | Field |
max_rows_per_merged_items (Optional) |
Specify the maximum number of rows that can be merged into a single item within the mosaic dataset. The default is 1,000 rows. If the maximum is exceeded, the tool will insert additional merged items for the selection or query. | Long |
Code Sample
This is a Python sample for the MergeMosaicDatasetItems tool.
import arcpy
arcpy.MergeMosaicDatasetItems_management("c:/data/merge_md_items.gdb/md",
"", "Year", "2000")
This is a Python script sample for the MergeMosaicDatasetItems tool.
#Merge items with items that are newer than year 1999
import arcpy
arcpy.MergeMosaicDatasetItems_management(
"c:/data/merge_md_items.gdb/md", "Year>1999", "", "1000")