Create Mosaic Dataset (Data Management)

Summary

Creates an empty mosaic dataset in a geodatabase.

Usage

• The mosaic dataset must be created in a geodatabase.

• Once the mosaic dataset is created, you can use the Add Rasters To Mosaic Dataset tool to populate it with rasters.

• Starting at ArcGIS AllSource 1.4, mosaic datasets created in Oracle, PostgreSQL, and SQL Server geodatabases will be created with the RASTERBLOB keyword. The RASTERBLOB keyword implements a transfer of the mosaic dataset catalog items to the DBMS.

• Mosaic datasets created with the RASTERBLOB keyword cannot be opened with earlier versions of the software. To create mosaic datasets that are backward compatible with earlier versions, alter the configuration keyword for RASTER_STORAGE to one of the following compatible keywords:

  • BINARY for PostgreSQL and SQL Server
  • BLOB for Oracle

• The name of the mosaic dataset must be in accordance with the limits of the geodatabase or underlying database; for example, the name cannot start with a number.

Parameters

Dialog

Label	Explanation	Data Type
Output Location	The path to the geodatabase.	Workspace
Mosaic Dataset Name	The name of the new mosaic dataset.	String
Coordinate System	The coordinate system that will be used for all of the items in the mosaic dataset.	Coordinate System
Number of Bands (Optional)	The number of bands the raster datasets will have in the mosaic dataset.	Long
Pixel Type (Optional)	Specifies the bit depth, or radiometric resolution, that will be used for the mosaic dataset. If not defined, the pixel type of the first raster dataset will be used. 1 bit—The pixel type will be a 1-bit unsigned integer. The values can be 0 or 1. 2 bit—The pixel type will be a 2-bit unsigned integer. The values supported can range from 0 to 3. 4 bit—The pixel type will be a 4-bit unsigned integer. The values supported can range from 0 to 15. 8-bit unsigned—The pixel type will be an unsigned 8-bit data type. The values supported can range from 0 to 255. 8-bit signed—The pixel type will be a signed 8-bit data type. The values supported can range from -128 to 127. 16-bit unsigned—The pixel type will be a 16-bit unsigned data type. The values can range from 0 to 65,535. 16-bit signed—The pixel type will be a 16-bit signed data type. The values can range from -32,768 to 32,767. 32-bit unsigned—The pixel type will be a 32-bit unsigned data type. The values can range from 0 to 4,294,967,295. 32-bit signed—The pixel type will be a 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647. 32-bit floating point—The pixel type will be a 32-bit data type supporting decimals. 64 bit—The pixel type will be a 64-bit data type supporting decimals.	String
Product Definition (Optional)	Specifies whether a template is specific to the type of imagery you are working with or is generic. The generic options include the following standard raster data types: None—No band ordering is specified for the mosaic dataset. This is the default. Natural color—A 3-band mosaic dataset, with red, green, and blue wavelength ranges will be created. This is designed for natural color imagery. Natural color and infrared—A 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges will be created. U and V—A mosaic dataset displaying two variables will be created. Magnitude and Direction—A mosaic dataset displaying magnitude and direction will be created. Color infrared—A 3-band mosaic dataset, with near infrared, red, and green wavelength ranges will be created. BlackSky—A 3-band mosaic dataset using the BlackSky wavelength ranges will be created DMCii—A 3-band mosaic dataset using the DMCii wavelength ranges will be created. Deimos-2—A 4-band mosaic dataset using the Deimos-2 wavelength ranges will be created. DubaiSat-2—A 4-band mosaic dataset using the DubaiSat-2 wavelength ranges will be created. FORMOSAT-2—A 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges will be created. GeoEye-1—A 4-band mosaic dataset using the GeoEye-1 wavelength ranges will be created. GF-1 Panchromatic/Multispectral (PMS)—A 4-band mosaic dataset using the Gaofen-1 Panchromatic Multispectral Sensor wavelength ranges will be created. GF-1 Wide Field of View (WFV)—A 4-band mosaic dataset using the Gaofen-1 Wide Field of View Sensor wavelength ranges will be created. GF-2 Panchromatic/Multispectral (PMS)—A 4-band mosaic dataset using the Gaofen-2 Panchromatic Multispectral Sensor wavelength ranges will be created. GF-4 Panchromatic/Multispectral Imagery (PMI)—A 4-band mosaic dataset using the Gaofen-4 panchromatic and multispectral wavelength ranges will be created. HJ 1A/1B Multispectral/Hyperspectral—A 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges will be created. IKONOS—A 4-band mosaic dataset using the IKONOS wavelength ranges will be created. Jilin-1—A 3-band mosaic dataset using the Jilin-1 wavelength ranges will be created. KOMPSAT-2—A 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges will be created. KOMPSAT-3—A 4-band mosaic dataset using the KOMPSAT-3 wavelength ranges will be created. Landsat TM and ETM+—A 6-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors will be created. Landsat OLI—An 8-band mosaic dataset using the Landsat 8 wavelength ranges will be created. Landsat 9—An 8-band mosaic dataset using the Landsat 9 wavelength ranges will be created. Landsat MSS—A 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created. PlanetScope—A 5-band mosaic dataset using the PlanetScope wavelength ranges will be created. Pleiades 1—A 4-band mosaic dataset using the Pleiades 1 wavelength ranges will be created. Pleiades Neo—A 6-band mosaic dataset using the Pleiades Neo wavelength ranges will be created. QuickBird—A 4-band mosaic dataset using the QuickBird wavelength ranges will be created. RapidEye—A 5-band mosaic dataset using the RapidEye wavelength ranges will be created. Sentinel 2 MSI—A 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges will be created. SkySat-C—A 4-band mosaic dataset using the SkySat-C MSI wavelength ranges will be created. SPOT-5—A 4-band mosaic dataset using the SPOT-5 wavelength ranges will be created. SPOT-6—A 4-band mosaic dataset using the SPOT-6 wavelength ranges will be created. SPOT-7—A 4-band mosaic dataset using the SPOT-7 wavelength ranges will be created. SuperView-1—A 4-band mosaic dataset using the SuperView-1 wavelength ranges will be created. TH-01—A 4-band mosaic dataset using the Tian Hui-1 wavelength ranges will be created. Vision-1—A 4-band mosaic dataset using the Vision-1 wavelength ranges will be created. WorldView-2—An 8-band mosaic dataset using the WorldView-2 wavelength ranges will be created. WorldView-3—An 8-band mosaic dataset using the WorldView-3 wavelength ranges will be created. WorldView-4—A 4-band mosaic dataset using the WorldView-4 wavelength ranges will be created. ZY-1 Panchromatic/Multispectral—A 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges will be created. ZY-3 CRESDA—A 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges will be created. ZY3 SASMAC—A 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges will be created. Custom—The number of bands and the average wavelength for each band are defined using the Product Band Definitions parameter (product_band_definitions in Python).	String
Product Band Definitions (Optional)	The definitions of the bands. Edit Product Definition by adjusting the wavelength ranges, changing the band order, and adding new bands.	Value Table

Derived Output

Label	Explanation	Data Type
Output Mosaic Dataset	The updated mosaic dataset.	Mosaic Dataset

Python

arcpy.management.CreateMosaicDataset(in_workspace, in_mosaicdataset_name, coordinate_system, {num_bands}, {pixel_type}, {product_definition}, {product_band_definitions})

Name	Explanation	Data Type
in_workspace	The path to the geodatabase.	Workspace
in_mosaicdataset_name	The name of the new mosaic dataset.	String
coordinate_system	The coordinate system that will be used for all of the items in the mosaic dataset.	Coordinate System
num_bands (Optional)	The number of bands the raster datasets will have in the mosaic dataset.	Long
pixel_type (Optional)	Specifies the bit depth, or radiometric resolution, that will be used for the mosaic dataset. If not defined, the pixel type of the first raster dataset will be used. 1_BIT—The pixel type will be a 1-bit unsigned integer. The values can be 0 or 1. 2_BIT—The pixel type will be a 2-bit unsigned integer. The values supported can range from 0 to 3. 4_BIT—The pixel type will be a 4-bit unsigned integer. The values supported can range from 0 to 15. 8_BIT_UNSIGNED—The pixel type will be an unsigned 8-bit data type. The values supported can range from 0 to 255. 8_BIT_SIGNED—The pixel type will be a signed 8-bit data type. The values supported can range from -128 to 127. 16_BIT_UNSIGNED—The pixel type will be a 16-bit unsigned data type. The values can range from 0 to 65,535. 16_BIT_SIGNED—The pixel type will be a 16-bit signed data type. The values can range from -32,768 to 32,767. 32_BIT_UNSIGNED—The pixel type will be a 32-bit unsigned data type. The values can range from 0 to 4,294,967,295. 32_BIT_SIGNED—The pixel type will be a 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647. 32_BIT_FLOAT—The pixel type will be a 32-bit data type supporting decimals. 64_BIT—The pixel type will be a 64-bit data type supporting decimals.	String
product_definition (Optional)	Specifies whether a template is specific to the type of imagery you are working with or is generic. The generic options include the following standard raster data types: NONE—No band ordering is specified for the mosaic dataset. This is the default. NATURAL_COLOR_RGB—A 3-band mosaic dataset, with red, green, and blue wavelength ranges will be created. This is designed for natural color imagery. NATURAL_COLOR_RGBI—A 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges will be created. VECTOR_FIELD_UV—A mosaic dataset displaying two variables will be created. VECTOR_FIELD_MAGNITUDE_DIRECTION—A mosaic dataset displaying magnitude and direction will be created. FALSE_COLOR_IRG—A 3-band mosaic dataset, with near infrared, red, and green wavelength ranges will be created. BLACKSKY—A 3-band mosaic dataset using the BlackSky wavelength ranges will be created DMCII_3BANDS—A 3-band mosaic dataset using the DMCii wavelength ranges will be created. DEIMOS2_4BANDS—A 4-band mosaic dataset using the Deimos-2 wavelength ranges will be created. DUBAISAT-2_4BANDS—A 4-band mosaic dataset using the DubaiSat-2 wavelength ranges will be created. FORMOSAT-2_4BANDS—A 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges will be created. GEOEYE-1_4BANDS—A 4-band mosaic dataset using the GeoEye-1 wavelength ranges will be created. GF-1 PMS_4BANDS—A 4-band mosaic dataset using the Gaofen-1 Panchromatic Multispectral Sensor wavelength ranges will be created. GF-1 WFV_4BANDS—A 4-band mosaic dataset using the Gaofen-1 Wide Field of View Sensor wavelength ranges will be created. GF-2 PMS_4BANDS—A 4-band mosaic dataset using the Gaofen-2 Panchromatic Multispectral Sensor wavelength ranges will be created. GF-4 PMI_4BANDS—A 4-band mosaic dataset using the Gaofen-4 panchromatic and multispectral wavelength ranges will be created. HJ 1A/1B CCD_4BANDS—A 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges will be created. IKONOS_4BANDS—A 4-band mosaic dataset using the IKONOS wavelength ranges will be created. JILIN-1_3BANDS—A 3-band mosaic dataset using the Jilin-1 wavelength ranges will be created. KOMPSAT-2_4BANDS—A 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges will be created. KOMPSAT-3_4BANDS—A 4-band mosaic dataset using the KOMPSAT-3 wavelength ranges will be created. LANDSAT_6BANDS—A 6-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors will be created. LANDSAT_8BANDS—An 8-band mosaic dataset using the Landsat 8 wavelength ranges will be created. LANDSAT_9BANDS—An 8-band mosaic dataset using the Landsat 9 wavelength ranges will be created. LANDSAT_MSS_4BANDS—A 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created. PLANETSCOPE—A 5-band mosaic dataset using the PlanetScope wavelength ranges will be created. PLEIADES-1_4BANDS—A 4-band mosaic dataset using the Pleiades 1 wavelength ranges will be created. PLEIADES_NEO_6BANDS—A 6-band mosaic dataset using the Pleiades Neo wavelength ranges will be created. QUICKBIRD_4BANDS—A 4-band mosaic dataset using the QuickBird wavelength ranges will be created. RAPIDEYE_5BANDS—A 5-band mosaic dataset using the RapidEye wavelength ranges will be created. SENTINEL2_13BANDS—A 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges will be created. SKYSAT_4BANDS—A 4-band mosaic dataset using the SkySat-C MSI wavelength ranges will be created. SPOT-5_4BANDS—A 4-band mosaic dataset using the SPOT-5 wavelength ranges will be created. SPOT-6_4BANDS—A 4-band mosaic dataset using the SPOT-6 wavelength ranges will be created. SPOT-7_4BANDS—A 4-band mosaic dataset using the SPOT-7 wavelength ranges will be created. SUPERVIEW-1_4BANDS—A 4-band mosaic dataset using the SuperView-1 wavelength ranges will be created. TH-01_4BANDS—A 4-band mosaic dataset using the Tian Hui-1 wavelength ranges will be created. WORLDVIEW-2_8BANDS—An 8-band mosaic dataset using the WorldView-2 wavelength ranges will be created. WORLDVIEW-3_8BANDS—An 8-band mosaic dataset using the WorldView-3 wavelength ranges will be created. WORLDVIEW-4_4BANDS—A 4-band mosaic dataset using the WorldView-4 wavelength ranges will be created. VISION-1_4BANDS—A 4-band mosaic dataset using the Vision-1 wavelength ranges will be created. ZY1-02C PMS_3BANDS—A 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges will be created. ZY3-CRESDA_4BANDS—A 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges will be created. ZY3-SASMAC_4BANDS—A 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges will be created. CUSTOM—The number of bands and the average wavelength for each band are defined using the Product Band Definitions parameter (product_band_definitions in Python).	String
product_band_definitions [Band Name {Wavelength Minimum} {Wavelength Maximum},...] (Optional)	The definitions of the bands. Edit product_definition when using the CUSTOM keyword by adjusting the wavelength ranges, changing the band order, and adding new bands.	Value Table

Derived Output

Name	Explanation	Data Type
out_mosaic_dataset	The updated mosaic dataset.	Mosaic Dataset

Code sample

CreateMosaicDataset example 1 (Python window)

This is a Python sample for the CreateMosaicDataset function.

import arcpy
arcpy.CreateMosaicDataset_management(
     "C:/workspace/CreateMD.gdb","mosaicds", 
     "C:/workspace/World_Mercator.prj", "3", 
     "8_BIT_UNSIGNED", "False Color Infrared")

CreateMosaicDataset example 2 (stand-alone script)

This is a Python script sample for the CreateMosaicDataset function.

#Create 3-Band FGDB Mosaic Dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"

gdbname = "CreateMD.gdb"
mdname = "mosaicds"
prjfile = "C:/Workspace/World_Mercator.prj"
noband = "3"
pixtype = "8_BIT_UNSIGNED"
pdef = "NONE"
wavelength = ""

arcpy.CreateMosaicDataset_management(gdbname, mdname, prjfile, noband, 
                                     pixtype, pdef, wavelength)

Environments

Output CONFIG Keyword