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 be in accordance with the limits of the geodatabase or underlying database; for example, the name cannot start with a number.

Parameters

LabelExplanationData 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 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 bitThe pixel type will be a 1-bit unsigned integer. The values can be 0 or 1.
  • 2 bitThe pixel type will be a 2-bit unsigned integer. The values supported can range from 0 to 3.
  • 4 bitThe pixel type will be a 4-bit unsigned integer. The values supported can range from 0 to 15.
  • 8-bit unsignedThe pixel type will be an unsigned 8-bit data type. The values supported can range from 0 to 255.
  • 8-bit signedThe pixel type will be a signed 8-bit data type. The values supported can range from -128 to 127.
  • 16-bit unsignedThe pixel type will be a 16-bit unsigned data type. The values can range from 0 to 65,535.
  • 16-bit signedThe pixel type will be a 16-bit signed data type. The values can range from -32,768 to 32,767.
  • 32-bit unsignedThe pixel type will be a 32-bit unsigned data type. The values can range from 0 to 4,294,967,295.
  • 32-bit signedThe 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 pointThe pixel type will be a 32-bit data type supporting decimals.
  • 64 bitThe 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:

  • NoneNo band ordering is specified for the mosaic dataset. This is the default.
  • Natural colorA 3-band mosaic dataset, with red, green, and blue wavelength ranges will be created. This is designed for natural color imagery.
  • Natural color and infraredA 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges will be created.
  • U and VA mosaic dataset displaying two variables will be created.
  • Magnitude and DirectionA mosaic dataset displaying magnitude and direction will be created.
  • Color infraredA 3-band mosaic dataset, with near infrared, red, and green wavelength ranges will be created.
  • DMCiiA 3-band mosaic dataset using the DMCii wavelength ranges will be created.
  • Deimos-2A 4-band mosaic dataset using the Deimos-2 wavelength ranges will be created.
  • DubaiSat-2A 4-band mosaic dataset using the DubaiSat-2 wavelength ranges will be created.
  • FORMOSAT-2A 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges will be created.
  • GeoEye-1A 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/HyperspectralA 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges will be created.
  • IKONOSA 4-band mosaic dataset using the IKONOS wavelength ranges will be created.
  • Jilin-1A 3-band mosaic dataset using the Jilin-1 wavelength ranges will be created.
  • KOMPSAT-2A 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges will be created.
  • KOMPSAT-3A 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 OLIAn 8-band mosaic dataset using the LANDSAT 8 wavelength ranges will be created.
  • Landsat 9An 8-band mosaic dataset using the LANDSAT 9 wavelength ranges will be created.
  • Landsat MSSA 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created.
  • Pleiades 1A 4-band mosaic dataset using the PLEIADES-1 wavelength ranges will be created.
  • Pleiades NeoA 6-band mosaic dataset using the Pleiades Neo wavelength ranges will be created.
  • QuickBirdA 4-band mosaic dataset using the QuickBird wavelength ranges will be created.
  • RapidEyeA 5-band mosaic dataset using the RapidEye wavelength ranges will be created.
  • Sentinel 2 MSIA 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges will be created.
  • SkySat-CA 4-band mosaic dataset using the SkySat-C MSI wavelength ranges will be created.
  • SPOT-5A 4-band mosaic dataset using the SPOT-5 wavelength ranges will be created.
  • SPOT-6A 4-band mosaic dataset using the SPOT-6 wavelength ranges will be created.
  • SPOT-7A 4-band mosaic dataset using the SPOT-7 wavelength ranges will be created.
  • SuperView-1A 4-band mosaic dataset using the SuperView-1 wavelength ranges will be created.
  • TH-01A 4-band mosaic dataset using the Tian Hui-1 wavelength ranges will be created.
  • WorldView-2An 8-band mosaic dataset using the WorldView-2 wavelength ranges will be created.
  • WorldView-3An 8-band mosaic dataset using the WorldView-3 wavelength ranges will be created.
  • WorldView-4A 4-band mosaic dataset using the WorldView-4 wavelength ranges will be created.
  • ZY-1 Panchromatic/MultispectralA 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges will be created.
  • ZY-3 CRESDAA 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges will be created.
  • ZY3 SASMACA 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges will be created.
  • CustomThe 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

LabelExplanationData Type
Output Mosaic Dataset

The updated mosaic dataset.

Mosaic Dataset

arcpy.management.CreateMosaicDataset(in_workspace, in_mosaicdataset_name, coordinate_system, {num_bands}, {pixel_type}, {product_definition}, {product_band_definitions})
NameExplanationData 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 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_BITThe pixel type will be a 1-bit unsigned integer. The values can be 0 or 1.
  • 2_BITThe pixel type will be a 2-bit unsigned integer. The values supported can range from 0 to 3.
  • 4_BITThe pixel type will be a 4-bit unsigned integer. The values supported can range from 0 to 15.
  • 8_BIT_UNSIGNEDThe pixel type will be an unsigned 8-bit data type. The values supported can range from 0 to 255.
  • 8_BIT_SIGNEDThe pixel type will be a signed 8-bit data type. The values supported can range from -128 to 127.
  • 16_BIT_UNSIGNEDThe pixel type will be a 16-bit unsigned data type. The values can range from 0 to 65,535.
  • 16_BIT_SIGNEDThe pixel type will be a 16-bit signed data type. The values can range from -32,768 to 32,767.
  • 32_BIT_UNSIGNEDThe pixel type will be a 32-bit unsigned data type. The values can range from 0 to 4,294,967,295.
  • 32_BIT_SIGNEDThe 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_FLOATThe pixel type will be a 32-bit data type supporting decimals.
  • 64_BITThe 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:

  • NONENo band ordering is specified for the mosaic dataset. This is the default.
  • NATURAL_COLOR_RGBA 3-band mosaic dataset, with red, green, and blue wavelength ranges will be created. This is designed for natural color imagery.
  • NATURAL_COLOR_RGBIA 4-band mosaic dataset, with red, green, blue, and near infrared wavelength ranges will be created.
  • VECTOR_FIELD_UVA mosaic dataset displaying two variables will be created.
  • VECTOR_FIELD_MAGNITUDE_DIRECTIONA mosaic dataset displaying magnitude and direction will be created.
  • FALSE_COLOR_IRGA 3-band mosaic dataset, with near infrared, red, and green wavelength ranges will be created.
  • DMCII_3BANDSA 3-band mosaic dataset using the DMCii wavelength ranges will be created.
  • DEIMOS2_4BANDSA 4-band mosaic dataset using the Deimos-2 wavelength ranges will be created.
  • DUBAISAT-2_4BANDSA 4-band mosaic dataset using the DubaiSat-2 wavelength ranges will be created.
  • FORMOSAT-2_4BANDSA 4-band mosaic dataset using the FORMOSAT-2 wavelength ranges will be created.
  • GEOEYE-1_4BANDSA 4-band mosaic dataset using the GeoEye-1 wavelength ranges will be created.
  • GF-1 PMS_4BANDSA 4-band mosaic dataset using the Gaofen-1 Panchromatic Multispectral Sensor wavelength ranges will be created.
  • GF-1 WFV_4BANDSA 4-band mosaic dataset using the Gaofen-1 Wide Field of View Sensor wavelength ranges will be created.
  • GF-2 PMS_4BANDSA 4-band mosaic dataset using the Gaofen-2 Panchromatic Multispectral Sensor wavelength ranges will be created.
  • GF-4 PMI_4BANDSA 4-band mosaic dataset using the Gaofen-4 panchromatic and multispectral wavelength ranges will be created.
  • HJ 1A/1B CCD_4BANDSA 4-band mosaic dataset using the Huan Jing-1 CCD Multispectral or Hyperspectral Sensor wavelength ranges will be created.
  • IKONOS_4BANDSA 4-band mosaic dataset using the IKONOS wavelength ranges will be created.
  • JILIN-1_3BANDSA 3-band mosaic dataset using the Jilin-1 wavelength ranges will be created.
  • KOMPSAT-2_4BANDSA 4-band mosaic dataset using the KOMPSAT-2 wavelength ranges will be created.
  • KOMPSAT-3_4BANDSA 4-band mosaic dataset using the KOMPSAT-3 wavelength ranges will be created.
  • LANDSAT_6BANDSA 6-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors will be created.
  • LANDSAT_8BANDSAn 8-band mosaic dataset using the LANDSAT 8 wavelength ranges will be created.
  • LANDSAT_9BANDSAn 8-band mosaic dataset using the LANDSAT 9 wavelength ranges will be created.
  • LANDSAT_MSS_4BANDSA 4-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor will be created.
  • PLEIADES-1_4BANDSA 4-band mosaic dataset using the PLEIADES-1 wavelength ranges will be created.
  • PLEIADES_NEO_6BANDSA 6-band mosaic dataset using the Pleiades Neo wavelength ranges will be created.
  • QUICKBIRD_4BANDSA 4-band mosaic dataset using the QuickBird wavelength ranges will be created.
  • RAPIDEYE_5BANDSA 5-band mosaic dataset using the RapidEye wavelength ranges will be created.
  • SENTINEL2_13BANDSA 13-band mosaic dataset using the Sentinel 2 MSI wavelength ranges will be created.
  • SKYSAT_4BANDSA 4-band mosaic dataset using the SkySat-C MSI wavelength ranges will be created.
  • SPOT-5_4BANDSA 4-band mosaic dataset using the SPOT-5 wavelength ranges will be created.
  • SPOT-6_4BANDSA 4-band mosaic dataset using the SPOT-6 wavelength ranges will be created.
  • SPOT-7_4BANDSA 4-band mosaic dataset using the SPOT-7 wavelength ranges will be created.
  • SUPERVIEW-1_4BANDSA 4-band mosaic dataset using the SuperView-1 wavelength ranges will be created.
  • TH-01_4BANDSA 4-band mosaic dataset using the Tian Hui-1 wavelength ranges will be created.
  • WORLDVIEW-2_8BANDSAn 8-band mosaic dataset using the WorldView-2 wavelength ranges will be created.
  • WORLDVIEW-3_8BANDSAn 8-band mosaic dataset using the WorldView-3 wavelength ranges will be created.
  • WORLDVIEW-4_4BANDSA 4-band mosaic dataset using the WorldView-4 wavelength ranges will be created.
  • ZY1-02C PMS_3BANDSA 3-band mosaic dataset using the ZiYuan-1 panchromatic/multispectral wavelength ranges will be created.
  • ZY3-CRESDA_4BANDSA 4-band mosaic dataset using the ZiYuan-3 CRESDA wavelength ranges will be created.
  • ZY3-SASMAC_4BANDSA 4-band mosaic dataset using the ZiYuan-3 SASMAC wavelength ranges will be created.
  • CUSTOMThe 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

NameExplanationData 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)

Licensing information

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

Related topics