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 Pro 1.4, mosaic datasets created in Oracle, PostgreSQL, and SQL Server geodatabases will be created with the new RASTER_STORAGE keyword called RASTERBLOB. The RASTERBLOB keyword implements an efficient transfer of the mosaic dataset catalog items to the DBMS.

• Mosaic datasets created with RASTERBLOB cannot be opened with earlier versions of the software. To create mosaic datasets that are backward compatible with earlier versions, you will need to 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 stay within 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. Starting at ArcGIS Pro 1.4, mosaic datasets created in Oracle, PostgreSQL, and SQL Server geodatabases will be created with the new RASTER_STORAGE keyword called RASTERBLOB. The RASTERBLOB keyword implements an efficient transfer of the mosaic dataset catalog items to the DBMS. Mosaic datasets created with RASTERBLOB cannot be opened with earlier versions of the software. To create mosaic datasets that are backward compatible with earlier versions, you will need to alter the configuration keyword for RASTER_STORAGE to one of the following compatible keywords: BINARY for PostgreSQL and SQL Server BLOB for Oracle	Workspace
Mosaic Dataset Name	The name of the mosaic dataset you are creating.	String
Coordinate System	The coordinate system 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)	Set the bit depth, or radiometric resolution, of the mosaic dataset. If not defined, it will be taken from the first raster dataset. 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 a template that is either specific to the type of imagery you are working with or is generic. The generic options include the standard raster data types as follows: 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. 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 MSS—A 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created. Pleiades 1—A 4-band mosaic dataset using the PLEIADES-1 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. TH-01—A 4-band mosaic dataset using the Tian Hui-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)	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. Starting at ArcGIS Pro 1.4, mosaic datasets created in Oracle, PostgreSQL, and SQL Server geodatabases will be created with the new RASTER_STORAGE keyword called RASTERBLOB. The RASTERBLOB keyword implements an efficient transfer of the mosaic dataset catalog items to the DBMS. Mosaic datasets created with RASTERBLOB cannot be opened with earlier versions of the software. To create mosaic datasets that are backward compatible with earlier versions, you will need to alter the configuration keyword for RASTER_STORAGE to one of the following compatible keywords: BINARY for PostgreSQL and SQL Server BLOB for Oracle	Workspace
in_mosaicdataset_name	The name of the mosaic dataset you are creating.	String
coordinate_system	The coordinate system 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)	Set the bit depth, or radiometric resolution, of the mosaic dataset. If not defined, it will be taken from the first raster dataset. 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 a template that is either specific to the type of imagery you are working with or is generic. The generic options include the standard raster data types as follows: 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. 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_MSS_4BANDS—A 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created. PLEIADES-1_4BANDS—A 4-band mosaic dataset using the PLEIADES-1 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. 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. 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)	Edit the product_definition by adjusting the wavelength ranges, changing the band order, and adding new bands when using the CUSTOM product definition.	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 CreateMosaicDataset.

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 CreateMosaicDataset.

#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

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes