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, or 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. If you want 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, or 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. If you want 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 —A 1-bit unsigned integer. The values can be 0 or 1. 2 bit —A 2-bit unsigned integer. The values supported can be from 0 to 3. 4 bit —A 4-bit unsigned integer. The values supported can be from 0 to 15. 8-bit unsigned —An unsigned 8-bit data type. The values supported can be from 0 to 255. 8-bit signed —A signed 8-bit data type. The values supported can be from -128 to 127. 16-bit unsigned —A 16-bit unsigned data type. The values can range from 0 to 65,535. 16-bit signed —A 16-bit signed data type. The values can range from -32,768 to 32,767. 32-bit unsigned —A 32-bit unsigned data type. The values can range from 0 to 4,294,967,295. 32-bit signed —A 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647. 32-bit floating point —A 32-bit data type supporting decimals. 64 bit —A 64-bit data type supporting decimals.	String
Product Definition (Optional)	Select 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 —Create a 3-band mosaic dataset, with red, green, and blue wavelength ranges. This is designed for natural color imagery. Natural color and infrared —Create a 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges. U and V —Create a mosaic dataset displaying two variables. Magnitude and Direction —Create a mosaic dataset displaying magnitude and direction. Color infrared —Create a 3-band mosaic dataset, with near infrared, red, and green wavelength ranges. DMCii —Create a 3-band mosaic dataset using the DMCii wavelength ranges. Deimos-2 —Create a 4-band mosaic dataset using the Deimos-2 wavelength ranges. DubaiSat-2 —Create a 4-band mosaic dataset using the DubaiSat-2 wavelength ranges. FORMOSAT-2 —Create a 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges. GeoEye-1 —Create a 4-band mosaic dataset using the GeoEye-1 wavelength ranges. GF-1 Panchromatic/Multispectral (PMS) —Create a 4-band mosaic dataset using the Gaofen-1 Panchromatic Multispectral Sensor wavelength ranges. GF-1 Wide Field of View (WFV) —Create a 4-band mosaic dataset using the Gaofen-1 Wide Field of View Sensor wavelength ranges. GF-2 Panchromatic/Multispectral (PMS) —Create a 4-band mosaic dataset using the Gaofen-2 Panchromatic Multispectral Sensor wavelength ranges. GF-4 Panchromatic/Multispectral Imagery (PMI) —Create a 4-band mosaic dataset using the Gaofen-4 panchromatic and multispectral wavelength ranges. HJ 1A/1B Multispectral/Hyperspectral —Create a 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges. IKONOS —Create a 4-band mosaic dataset using the IKONOS wavelength ranges. Jilin-1 —Create a 3-band mosaic dataset using the Jilin-1 wavelength ranges. KOMPSAT-2 —Create a 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges. KOMPSAT-3 —Create a 4-band mosaic dataset using the KOMPSAT-3 wavelength ranges. Landsat TM and ETM+ —Create a 6-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors. Landsat OLI —Create an 8-band mosaic dataset using the LANDSAT 8 wavelength ranges. Landsat MSS —Create a 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor. PlanetScope —Create a mosaic dataset using the PlanetScope wavelength ranges. Pleiades 1 —Create a 4-band mosaic dataset using the PLEIADES-1 wavelength ranges. QuickBird —Create a 4-band mosaic dataset using the QuickBird wavelength ranges. RapidEye —Create a 5-band mosaic dataset using the RapidEye wavelength ranges. Sentinel 2 MSI —Create a 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges. SkySat-C —Create a 4-band mosaic dataset using the SkySat-C MSI wavelength ranges. Spot 5 —Create a 4-band mosaic dataset using the SPOT-5 wavelength ranges. Spot 6 —Create a 4-band mosaic dataset using the SPOT-6 wavelength ranges. Spot 7 —Create a 4-band mosaic dataset using the SPOT-7 wavelength ranges. TH-01 —Create a 4-band mosaic dataset using the Tian Hui-1 wavelength ranges. WorldView 2 —Create an 8-band mosaic dataset using the WorldView-2 wavelength ranges. WorldView 3 —Create an 8-band mosaic dataset using the WorldView-3 wavelength ranges. WorldView 4 —Create a 4-band mosaic dataset using the WorldView-4 wavelength ranges. ZY-1 Panchromatic/Multispectral —Create a 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges. ZY-3 CRESDA —Create a 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges. ZY3 SASMAC —Create a 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges. Custom —Define the number of bands and the average wavelength for each band.	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, or 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. If you want 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 —A 1-bit unsigned integer. The values can be 0 or 1. 2_BIT —A 2-bit unsigned integer. The values supported can be from 0 to 3. 4_BIT —A 4-bit unsigned integer. The values supported can be from 0 to 15. 8_BIT_UNSIGNED —An unsigned 8-bit data type. The values supported can be from 0 to 255. 8_BIT_SIGNED —A signed 8-bit data type. The values supported can be from -128 to 127. 16_BIT_UNSIGNED —A 16-bit unsigned data type. The values can range from 0 to 65,535. 16_BIT_SIGNED —A 16-bit signed data type. The values can range from -32,768 to 32,767. 32_BIT_UNSIGNED —A 32-bit unsigned data type. The values can range from 0 to 4,294,967,295. 32_BIT_SIGNED —A 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647. 32_BIT_FLOAT —A 32-bit data type supporting decimals. 64_BIT —A 64-bit data type supporting decimals.	String
product_definition (Optional)	Select 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 —Create a 3-band mosaic dataset, with red, green, and blue wavelength ranges. This is designed for natural color imagery. NATURAL_COLOR_RGBI —Create a 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges. VECTOR_FIELD_UV —Create a mosaic dataset displaying two variables. VECTOR_FIELD_MAGNITUDE_DIRECTION —Create a mosaic dataset displaying magnitude and direction. FALSE_COLOR_IRG —Create a 3-band mosaic dataset, with near infrared, red, and green wavelength ranges. DMCII_3BANDS —Create a 3-band mosaic dataset using the DMCii wavelength ranges. DEIMOS2_4BANDS —Create a 4-band mosaic dataset using the Deimos-2 wavelength ranges. DUBAISAT-2_4BANDS —Create a 4-band mosaic dataset using the DubaiSat-2 wavelength ranges. FORMOSAT-2_4BANDS —Create a 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges. GEOEYE-1_4BANDS —Create a 4-band mosaic dataset using the GeoEye-1 wavelength ranges. GF-1 PMS_4BANDS —Create a 4-band mosaic dataset using the Gaofen-1 Panchromatic Multispectral Sensor wavelength ranges. GF-1 WFV_4BANDS —Create a 4-band mosaic dataset using the Gaofen-1 Wide Field of View Sensor wavelength ranges. GF-2 PMS_4BANDS —Create a 4-band mosaic dataset using the Gaofen-2 Panchromatic Multispectral Sensor wavelength ranges. GF-4 PMI_4BANDS —Create a 4-band mosaic dataset using the Gaofen-4 panchromatic and multispectral wavelength ranges. HJ 1A/1B CCD_4BANDS —Create a 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges. IKONOS_4BANDS —Create a 4-band mosaic dataset using the IKONOS wavelength ranges. JILIN-1_3BANDS —Create a 3-band mosaic dataset using the Jilin-1 wavelength ranges. KOMPSAT-2_4BANDS —Create a 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges. KOMPSAT-3_4BANDS —Create a 4-band mosaic dataset using the KOMPSAT-3 wavelength ranges. LANDSAT_6BANDS —Create a 6-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors. LANDSAT_8BANDS —Create an 8-band mosaic dataset using the LANDSAT 8 wavelength ranges. LANDSAT_MSS_4BANDS —Create a 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor. PlanetScope —Create a mosaic dataset using the PlanetScope wavelength ranges. PLEIADES-1_4BANDS —Create a 4-band mosaic dataset using the PLEIADES-1 wavelength ranges. QUICKBIRD_4BANDS —Create a 4-band mosaic dataset using the QuickBird wavelength ranges. RAPIDEYE_5BANDS —Create a 5-band mosaic dataset using the RapidEye wavelength ranges. SENTINEL2_13BANDS —Create a 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges. SKYSAT_4BANDS —Create a 4-band mosaic dataset using the SkySat-C MSI wavelength ranges. SPOT-5_4BANDS —Create a 4-band mosaic dataset using the SPOT-5 wavelength ranges. SPOT-6_4BANDS —Create a 4-band mosaic dataset using the SPOT-6 wavelength ranges. SPOT-7_4BANDS —Create a 4-band mosaic dataset using the SPOT-7 wavelength ranges. TH-01_4BANDS —Create a 4-band mosaic dataset using the Tian Hui-1 wavelength ranges. WORLDVIEW-2_8BANDS —Create an 8-band mosaic dataset using the WorldView-2 wavelength ranges. WORLDVIEW-3_8BANDS —Create an 8-band mosaic dataset using the WorldView-3 wavelength ranges. WORLDVIEW-4_4BANDS —Create a 4-band mosaic dataset using the WorldView-4 wavelength ranges. ZY1-02C PMS_3BANDS —Create a 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges. ZY3-CRESDA_4BANDS —Create a 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges. ZY3-SASMAC_4BANDS —Create a 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges. CUSTOM —Define the number of bands and the average wavelength for each band.	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