Desktop Help 10.0 - Mosaic To New Raster (Data Management)

Summary

Mosaics multiple raster datasets into a new raster dataset.

Usage

The input raster datasets are all the raster datasets you would like to mosaic together. The inputs must have the same number of bands and same bit depth; otherwise, the tool will exit with an error message.
When working with a large number of raster datasets, the Raster Catalog To Raster Dataset tool performs more efficiently.
The Mosaic tool has more parameters available when combining datasets into an existing raster, such as options to ignore background and nodata values.
You must set the pixel type to match your existing input raster datasets. If you do not set the pixel type, the 8-bit default will be used and your output may be incorrect.
You can save your output to BIL, BIP, BMP, BSQ, DAT, GIF, GRID, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.
When storing your raster dataset to a JPEG file, a JPEG 2000 file, or a geodatabase, you can specify a Compression type and Compression Quality within the Environment Settings.
The GIF format only supports single-band raster datasets.
When mosaicking with raster datasets containing colormaps, it is important to note differences across the colormaps for each raster dataset you choose to mosaic. In this situation, use the Mosaic tool for raster with different colormaps; however, you must choose the proper Mosaic Colormap Mode operator. If an improper colormap mode is chosen, your output might not turn out as you expected.
This tool does not honor the Output extent environment setting for SDE. If you want a specific extent for your output raster, consider using the Clip tool. You can either clip the input rasters prior to using this tool, or clip the output of this tool.

Syntax

MosaicToNewRaster_management (input_rasters, output_location, raster_dataset_name_with_extension, {coordinate_system_for_the_raster}, {Pixel_type}, {cellsize}, Number_of_bands, {mosaic_method}, {mosaic_colormap_mode})

Parameter	Explanation	Data Type
input_rasters [input_raster,...]	The input raster datasets.	Raster layer
output_location	The path to contain the raster dataset. The path can be to a folder or geodatabase.	Workspace ; Raster catalog
raster_dataset_name_with_extension	The name and extension of the raster dataset to be created. When storing the raster dataset in a file format, you need to specify the file extension: .bil—ESRI BIL .bip—ESRI BIP .bmp—BMP .bsq—ESRI BSQ .dat—ENVI DAT .gif—GIF .img—ERDAS IMAGINE file .jpg—JPEG .jp2—JPEG 2000 .png—PNG .tif—TIFF no extension—ESRI GRID When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. When storing your raster dataset to a JPEG file, a JPEG 2000 file, a TIFF file, or a geodatabase, you can specify a compression type and compression quality.	String
coordinate_system_for_the_raster (Optional)	Specifies the map projection of the output raster mosaic.	Coordinate System
Pixel_type (Optional)	Specifies the bit depth of the output raster dataset. You must set the pixel type to match your existing input raster datasets. If you do not set the pixel type, the 8-bit default will be used and your output may be incorrect. 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
cellsize (Optional)	The cell size for the new raster dataset.	Double
Number_of_bands	The number of bands to be contained by the raster dataset.	Long
mosaic_method (Optional)	The method used to mosaic overlapping areas. FIRST —The output cell value of the overlapping areas will be the value from the first raster dataset mosaicked into that location. LAST —The output cell value of the overlapping areas will be the value from the last raster dataset mosaicked into that location. This is the default. BLEND —The output cell value of the overlapping areas will be a horizontally weighted calculation of the values of the cells in the overlapping area. MEAN —The output cell value of the overlapping areas will be the average value of the overlapping cells. MINIMUM —The output cell value of the overlapping areas will be the minimum value of the overlapping cells. MAXIMUM —The output cell value of the overlapping areas will be the maximum value of the overlapping cells. For more information about each mosaic operator, refer to Mosaic Operator.	String
mosaic_colormap_mode (Optional)	Applies when the input raster datasets have a colormap. The method used to choose which colormap from the input rasters will be applied to the mosaic output. FIRST —The colormap from the first raster dataset in the list will be applied to the output raster mosaic. This is the default. LAST —The colormap from the last raster dataset in the list will be applied to the output raster mosaic. MATCH —Will take all the colormaps into consideration when mosaicking. If all possible values are already used (for the bit depth), it will attempt to match the value with the closest color that is available. REJECT —Only the raster datasets that do not have a colormap associated with them will be mosaicked. For more information about each colormap mode, refer to Mosaic colormap mode.	String

Code Sample

MosaicToNewRaster example 1 (Python window)

This is a Python sample for the MosaicToNewRaster tool.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MosaicToNewRaster_management("land1.tif;land2.tif", "Mosaic2New", \
                                   "landnew.tif", "World_Mercator.prj",\
                                   "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")

MosaicToNewRaster example 2 (stand-alone script)

This is a Python script sample for the MosaicToNewRaster tool.

##==================================
##Mosaic To New Raster
##Usage: MosaicToNewRaster_management inputs;inputs... output_location raster_dataset_name_with_extension 
##                                    {coordinate_system_for_the_raster} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT 
##                                    | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_FLOAT | 32_BIT_UNSIGNED 
##                                    | 32_BIT_SIGNED | | 64_BIT {cellsize} number_of_bands {LAST | FIRST | BLEND  | MEAN 
##                                    | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH}                               
try:
    import arcpy
    arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
    ##Mosaic several TIFF images to a new TIFF image
    arcpy.MosaicToNewRaster_management("landsatb4a.tif;landsatb4b.tif","Mosaic2New", "landsat.tif", "World_Mercator.prj",\
                                       "8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
except:
    print "Mosaic To New Raster example failed."
    print arcpy.GetMessages()

Environments

Current Workspace, Output CONFIG Keyword, Output Coordinate System, Compression, Pyramid, Raster Statistics, Tile Size, Extent, Scratch Workspace

Extent: Not valid for ArcSDE

Licensing Information

ArcView: Yes

ArcEditor: Yes

ArcInfo: Yes

10/27/2014

Mosaic To New Raster (Data Management)