Create Mosaic Dataset (Data Management)

License Level:BasicStandardAdvanced

Summary

Makes an empty mosaic dataset in a geodatabase.

Usage

Syntax

CreateMosaicDataset_management (in_workspace, in_mosaicdataset_name, coordinate_system, {num_bands}, {pixel_type}, {product_definition}, {product_band_definitions})
ParameterExplanationData Type
in_workspace

The path and name of a geodatabase.

Workspace
in_mosaicdataset_name

The name of the mosaic dataset.

String
coordinate_system

The coordinate system for the mosaic dataset, which will be used for all the associated files or features created.

Spatial Reference
num_bands
(Optional)

The number of raster dataset bands supported by the mosaic dataset.

Long
pixel_type
(Optional)

The bit depth of a cell, used to determine the range of values that the mosaic dataset output. For example, an 8-bit mosaic dataset can have 256 unique pixel values, which range from 0 to 255.

If it is not defined, it will be taken from the first raster dataset.

  • 1_BITA 1-bit unsigned integer. The values can be 0 or 1.
  • 2_BITA 2-bit unsigned integer. The values supported can be from 0 to 3.
  • 4_BITA 4-bit unsigned integer. The values supported can be from 0 to 15.
  • 8_BIT_UNSIGNEDAn unsigned 8-bit data type. The values supported can be from 0 to 255.
  • 8_BIT_SIGNEDA signed 8-bit data type. The values supported can be from -128 to 127.
  • 16_BIT_UNSIGNEDA 16-bit unsigned data type. The values can range from 0 to 65,535.
  • 16_BIT_SIGNEDA 16-bit signed data type. The values can range from -32,768 to 32,767.
  • 32_BIT_UNSIGNEDA 32-bit unsigned data type. The values can range from 0 to 4,294,967,295.
  • 32_BIT_SIGNEDA 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647.
  • 32_BIT_FLOATA 32-bit data type supporting decimals.
  • 64_BITA 64-bit data type supporting decimals.
String
product_definition
(Optional)

A template defining the number of bands and mid-wavelength ranges for each band.

  • NoneNo band ordering is specified for the mosaic dataset. This is the default.
  • NATURAL_COLOR_RGBCreates a three-band mosaic dataset, with red, green, and blue wavelength ranges. This is designed for natural color imagery.
  • NATURAL_COLOR_RGBICreates a four-band mosaic dataset, with red, green, blue and near infrared wavelength ranges.
  • FALSE_COLOR_IRGCreates a three-band mosaic dataset, with near infrared, red, and green wavelength ranges.
  • DMCII_3BANDSCreates a three-band mosaic dataset using the DMCII wavelength ranges.
  • FORMOSAT-2_4BANDSCreates a four-band mosaic dataset using the FORMOSAT-2 wavelength ranges.
  • GEOEYE-1_4BANDSCreates a four-band mosaic dataset using the GeoEye-1 wavelength ranges.
  • IKONOS_4BANDS)Creates a four-band mosaic dataset using the IKONOS wavelength ranges.
  • KOMPSAT-2_4BANDSCreates a four-band mosaic dataset using the KOMPSAT-2 wavelength ranges.
  • LANDSAT_6BANDSCreates a six-band mosaic dataset using the Landsat 5 and 7 wavelength ranges from the TM and ETM+ sensors.
  • LANDSAT_8BANDSCreates an 8-band mosaic dataset using the LANDSAT 8 wavelength ranges.
  • LANDSAT_MSS_4BANDSCreates a four-band mosaic dataset using the Landsat wavelength ranges from the MSS sensor.
  • PLEIADES-1_4BANDSCreates a four-band mosaic dataset using the PLEIADES-1 wavelength ranges.
  • QUICKBIRD_4BANDSCreates a four-band mosaic dataset using the QuickBird wavelength ranges.
  • RAPIDEYE_5BANDSCreates a five-band mosaic dataset using the RapidEye wavelength ranges.
  • SPOT-5_4BANDSCreates a four-band mosaic dataset using the SPOT 5 wavelength ranges.
  • SPOT-6_4BANDSCreates a four-band mosaic dataset using the SPOT-6 wavelength ranges.
  • WORLDVIEW-2_8BANDSCreates an eight-band mosaic dataset using the WorldView-2 wavelength ranges.
  • CUSTOMAllows you to define the number of bands and the mid-wavelength ranges for each band.
String
product_band_definitions
[Band Name {Wavelength Minimum} {Wavelength Maximum},...]
(Optional)

The band and wavelength information for the product_definition can be edited. You can modify the wavelengths, change the band order, or you can add or remove bands when using the CUSTOM product definition.

Value Table

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 Coordinate System

Will only be used if the Coordinate System parameter is not defined

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
5/7/2015