Desktop Help 10.0 - Add Rasters To Mosaic Dataset (Data Management)

Summary

Adds raster datasets to a mosaic dataset from many sources, including a file, folder, raster catalog, table, or Web service.

Usage

Raster data that is added is unmanaged; therefore, if the raster data is deleted or moved the mosaic dataset will be affected.
You can only add rasters to a mosaic dataset contained within a geodatabase. Those created outside a geodatabase can only contain the contents of a raster catalog or previously created mosaic dataset.
The raster type identifies metadata required for loading data into the mosaic dataset. ArcGIS supports many default raster types, which are listed in Supported raster types.

Syntax

AddRastersToMosaicDataset_management (in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description})

Parameter	Explanation	Data Type
in_mosaic_dataset	The path and name of the mosaic dataset to which the raster data will be added.	Mosaic Dataset; Mosaic Layer
raster_type	The raster type is specific for imagery products. It identifies metadata, such as georeferencing, acquisition date, and sensor type, along with a raster format. For a list of default raster types, please refer to Supported raster types.	Raster Type
input_path [input_path,...]	Path and name of the file, folder, raster dataset, raster catalog, mosaic dataset, table, or service. File —Allows you to select one or more raster datasets stored in a folder on disk, an image service definition (.ISDef) file, and a raster process definition (.RPDef) file. Workspace —Allows you to select a folder containing multiple raster datasets. The folder can contain subfolders.This is affected by the Include Sub Folders and Filter parameters. Dataset —Allows you to select an ArcGIS geographic dataset, such as any raster, raster catalog, or mosaic dataset in a geodatabase, or a table. Service —Allows you to select a WCS, map, or image service, or a Web service layer file.	File; Workspace; Raster Dataset; Mosaic Dataset; Table; Raster Layer; Raster Catalog Layer; Mosaic Layer; WCS Coverage; Image Service; MapServer
update_cellsize_ranges (Optional)	Calculates the cell size ranges of each raster in the mosaic dataset. These values are written to the attribute table within the minPS and maxPS columns. UPDATE_CELL_SIZES —The cell size ranges will be calculated for all the rasters in the mosaic dataset. This is the default. NO_CELL_SIZES —The cell size ranges will not be calculated.	Boolean
update_boundary (Optional)	Generates or updates the boundary polygon of a mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels. UPDATE_BOUNDARY —The boundary will be generated or updated. This is the default. NO_BOUNDARY —The boundary will not be generated or updated.	Boolean
update_overviews (Optional)	Defines and generates overviews for a mosaic dataset. UPDATE_OVERVIEWS —Overviews will be defined and generated. NO_OVERVIEWS —Overviews will not be defined or generated. This is the default.	Boolean
maximum_pyramid_levels (Optional)	Defines the maximum number of pyramid levels that will be used in the mosaic dataset. For example, a value of 2 will use only the first two pyramid levels from the source raster. Leaving this blank or typing a value of -1 will build pyramids for all levels. This value can affect the display and the number of overviews that will be generated.	Long
maximum_cell_size (Optional)	Defines the maximum pyramid cell size that will be used in the mosaic dataset.	Double
minimum_dimension (Optional)	Defines the minimum dimensions of a raster pyramid that will be used in the mosaic dataset.	Long
spatial_reference (Optional)	Spatial reference system of the input data. This should be specified if the data does not have a coordinate system; otherwise, the coordinate system of the mosaic dataset will be used. This can also be used to override the coordinate system of the input data.	Spatial Reference
filter (Optional)	A file name filter for the data being added to the mosaic dataset. The wildcards for the filter can be a simple asterisk before a file extension, or it can be formatted using the PERL syntax. .TIF REGEX:.1923.\|.1922.* REGEX:.192[34567].\|.194.\|.195.	String
sub_folder (Optional)	Recursively explores subfolders. SUBFOLDERS —All subfolders will be explored for data. This is the default. NO_SUBFOLDERS —Only the top-level folder will be explored for data.	Boolean
duplicate_items_action (Optional)	A check will be performed to see if each raster has already been added, using the original path and file name. Choose which action to perform when a duplicate path and file name have been found. ALLOW_DUPLICATES —All rasters will be added even if they already exist within the mosaic dataset. This is the default. EXCLUDE_DUPLICATES —The duplicate raster will not be added. OVERWRITE_DUPLICATES —The duplicate raster will overwrite the existing one.	Boolean
build_pyramids (Optional)	Builds pyramids for each source raster. NO_PYRAMIDS —Pyramids will not be generated. This is the default. BUILD_PYRAMIDS —Pyramids will be generated.	Boolean
calculate_statistics (Optional)	Calculates statistics for each source raster. NO_STATISTICS —Statistics will not be generated. This is the default. CALCULATE_STATISTICS —Statistics will be generated.	Boolean
build_thumbnails (Optional)	Builds thumbnails for each source raster. NO_THUMBNAILS —Thumbnails will not be generated. This is the default. BUILD_THUMBNAILS —Thumbnails will be generated.	Boolean
operation_description (Optional)		String

Code Sample

AddRastersToMosaicDataset example 1 (Python window)

This is a Python sample for the AddRastersToMosaicDataset tool.

import arcpy
arcpy.AddRasters_management("c:/workspace/AddMD.gdb/md01", "Raster Dataset",\
                            "c:/data", "CALCULATE_CELL_SIZES", "BUILD_BOUNDARY",\                                            "BUILD_OVERVIEWS", "#", "#", "#",\
                            "World_Mercator.prj", ".tif", "NO_SUBFOLDERS",\
                            "EXCLUDE_DUPLICATES", "BUILD_PYRAMIDS",\
                            "CALCULATE_STATISTICS", "NO_THUMBNAILS", "Add Rasters")

AddRastersToMosaicDataset example 2 (stand-alone script)

This is a Python script sample for the AddRastersToMosaicDataset tool.

##===========================
##Add Rasters To Mosaic Dataset
##Usage: AddRastersToMosaicDataset_management in_mosaic_dataset raster_type input_path 
##                             {UPDATE_CELL_SIZES | NO_CELL_SIZES} {UPDATE_BOUNDARY
##                             | NO_BOUNDARY} {NO_OVERVIEWS | UPDATE_OVERVIEWS} 
##                             {maximum_pyramid_levels} {maximum_cell_size} 
##                             {minimum_dimension} {spatial_reference} {filter}
##                             {SUBFOLDERS | NO_SUBFOLDERS} {ALLOW_DUPLICATES
##                             | EXCLUDE_DUPLICATES | OVERWRITE_DUPLICATES}
##                             {NO_PYRAMIDS | BUILD_PYRAMIDS}
##                             {NO_STATISTICS | CALCULATE_STATISTICS} {NO_THUMBNAILS
##                             | BUILD_THUMBNAILS} {operation_description}
try:
    import arcpy
    arcpy.env.workspace = r"C:\Workspace"
    ##Add Raster Dataset type Raster to FGDB Mosaic Dataset
    ##Calculate Cell Size Ranges and Build Boundary
    ##Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
    ##Force Spatial Reference to World_Mercator
    ##Apply TIFF file filter
    ##Build Pyramids for the source datasets
    arcpy.AddRastersToMosaicDataset_management("AddMD.gdb/md_rasds", "Raster Dataset", "rasds",\
                                "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY", "UPDATE_OVERVIEWS",\
                                "2", "#", "#", "World_Mercator.prj", ".tif", "NO_SUBFOLDERS",\
                                "EXCLUDE_DUPLICATES", "BUILD_PYRAMIDS", "CALCULATE_STATISTICS",\
                                "NO_THUMBNAILS", "Add Raster Datasets")
    
    ##Add Landsat sensor type data to FGDB Mosaic Dataset
    ##Specify the Sensor template as Pansharpened
    ##Use Raster Dataset pyramid up to the cell size of 16
    ##Force Spatial Reference to GCS_WCS_1984
    ##Build Thumbnail for the Mosaic Dataset
    arcpy.AddRastersToMosaicDataset_management("AddMD.gdb/md_landsat","Landsat", "landsat", "UPDATE_CELL_SIZES",\
                                "UPDATE_BOUNDARY", "NO_OVERVIEWS", "#", "16", "#",\
                                "GCS_WGS_1984.prj", "#", "SUBFOLDERS", "EXCLUDE_DUPLICATES",\
                                "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",\
                                "Add Landsat L1G")
    ##Create SDE Mosaic Dataset
    arcpy.AddRastersToMosaicDataset_management("SDE94.sde/TOOLBOX.md_qb","QuickBird", "qb", "UPDATE_CELL_SIZES",\
                                "UPDATE_BOUNDARY", "NO_OVERVIEWS", "#", "#", "#",\
                                "GCS_WGS_1984.prj", "#", "SUBFOLDERS", "EXCLUDE_DUPLICATES",\
                                "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",\
                                "Add QuickBird")
except:
    print "Add Rasters To Mosaic Dataset example failed."
    print arcpy.GetMessages()

Environments

Current Workspace, Extent, Pyramid, Raster Statistics

Licensing Information

ArcView: No

ArcEditor: Yes

ArcInfo: Yes

10/27/2014

Add Rasters To Mosaic Dataset (Data Management)