Raster Catalog To Raster Dataset (Data Management)

Mosaics the contents of a raster catalog into a new raster dataset.

Usage tips

This tool allows you to convert your geodatabase raster catalog into a raster dataset; the input is a raster catalog and the output is a new raster dataset. This tool cannot mosaic to an existing raster dataset.

There are several advantages of using a mosaicked raster dataset: it tends to display faster at any scale, saves space since there is no overlapping data, and the data tends to display with fewer seams.

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 might turn out incorrectly.

You can save your output to BMP, GIF, GRID, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.

When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID.

When storing your raster dataset to a JPEG file or a JPEG 2000 file, you can specify the compression quality within the Raster Storage Settings in the Environment Settings.

The GIF format only supports single-band raster datasets.

The overlapping areas of the mosaic can be handled in several ways; for example, you can set the tool to keep only the first raster dataset's data, or you can blend the overlapping cell values. There are also several options to determine how to handle a colormap, if the raster dataset uses one. For example, you can keep the colormap of the last raster dataset used in the mosaic.

For mosaicking of discrete data, the First, Last, Minimum, and Maximum options give the most meaningful results. The Blend and Mean options are best suited for continuous data.

Whenever possible, use the Last mosaic option to mosaic raster datasets to an existing raster dataset in file geodatabase or ArcSDE geodatabase; it is by far the most effective way to mosaic.

When mosaicking with raster datasets containing colormaps, it is important to note differences across the colormaps for each raster dataset you choose to mosaic. You are still able to use the Mosaic tool even if the raster datasets have different colormaps; however, you must choose the proper colormap mode. If an improper colormap mode is chosen, your output might not turn out as you expected.

For floating-point input raster datasets of different resolutions, it is recommended that you resample all the data using bilinear interpolation or cubic convolution before running Mosaic. Otherwise, Mosaic will automatically resample the rasters using nearest neighbor (which is not appropriate for the continuous type of data).

Color matching and color correction can be used to make the raster mosaic more seamless.

The following environments affect this tool: current workspace, scratch workspace, and snap raster.

Syntax

RasterCatalogToRasterDataset_management (in_raster_catalog, out_raster_dataset, where_clause, mosaic_type, colormap, order_by_field, ascending, Pixel_type, ColorBalancing, MatchingMethod, ReferenceRaster, OID)

Parameter	Explanation	Datatype
Input Raster Catalog (Required)	The raster catalog that will be mosaicked to a raster dataset.	Raster catalog
Output Raster Dataset (Required)	The name and extension of the output raster dataset mosaic. The output is a new raster dataset. When storing a raster dataset in a geodatabase (personal, file, or ArcSDE), no file extension should be added to the name of the raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID. When storing your raster dataset to a JPEG file, a JPEG 2000 file, or a geodatabase, you can specify a compression type.	Raster dataset
Expression (Optional)	Enter the appropriate SQL statement to select specific rows in the raster catalog.	SQL expression
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 in the list. LAST—The output cell value of the overlapping areas will be the value from the last raster dataset in the list. This is the default (and is also the fastest mosaic type). BLEND—The output cell value of the overlapping areas will be a blend of values that overlap; this blend value relies on an algorithm that is weight based and dependent on the distance from the pixel to the edge within the overlapping area. MEAN—The output cell value of the overlapping areas will be the mean value of the overlapped cells. MINIMUM—The output cell value of the overlapping areas will be the minimum value of the overlapped cells. MAXIMUM—The output cell value of the overlapping areas will be the maximum value of the overlapped cells. For more information about each mosaic method, refer to the Mosaic methods help topic.	String
Mosaic Colormap Mode (Optional)	The method used to choose which colormap from the input rasters will be applied to the mosaic output. REJECT—Only the raster datasets that do not have a colormap associated with them will be mosaicked. FIRST—The colormap from the first raster dataset in the list will be applied to the output raster dataset. This is the default. LAST—The colormap from the last raster dataset in the list will be applied to the output raster dataset. MATCH—Makes sure that the colors in the final colormap are all unique. For more information about each colormap mode, please refer to the Mosaic colormap mode help topic.	String
Order By Field (Optional)	Define the field by which to order the raster catalog items.	Field
Ascending (Optional)	Choose whether to use the ascending value of the Order By field. If the Ascending option is not used, the descending order will be used. Ascending—The ascending order of the rows will be followed in the mosaic procedure. This is the default. None—The descending order of the rows will be followed in the mosaic procedure.	Boolean
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 might turn out incorrectly. 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 8-bit unsigned data type. The values can range from 0 to 255. This is the default. 8_BIT_SIGNED—An 8-bit signed data type. The values can range 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 supported by GRID. 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
Color Balancing (Optional)	Choose whether or not to use a dodging technique to color correct the raster catalog items. All pixels in the raster catalog will be used to determine the gamma and contrast values for the color-balancing algorithm. NONE—Color balancing will not be performed in the mosaic procedure. This is the default. ColorBalancing—Color balancing will be performed in the mosaic procedure.	Boolean
Matching Method (Optional)	Choose the color matching method to apply to the raster catalog items. NONE—No color matching will take place. StatisticMatching—This method will match the statistical differences (minimum, maximum, mean) between the reference overlap area and the source overlap area; then the transformation will be applied to the entire target dataset. HistogramMatching—This method will match the histogram from the reference overlap area with the source overlap area; then the transformation will be applied to the entire target. LinearCorrelationMatching—This method will match overlapped pixels and interpolate to the rest of the source; pixels that do not have a one-to-one relationship will use a weighted average.	String
Reference Raster (Optional)	If color matching is applied, choose how to specify the reference raster. CALCULATE_FROM_ALL—The system will calculate the best raster dataset to use, based on all the raster catalog items. SPECIFY_OID—The user will type in the Object ID (OID) of the raster catalog item to use as the reference raster. DEFINE_FROM_SELECTION—The system will calculate the best raster dataset to use, based on the raster catalog items that are selected.	String
Reference Raster OID (Optional)	The object ID (OID) of the reference raster. The OID is a unique key field in the raster catalog.	Long

Data types for geoprocessing tool parameters

Script Example

#Create the geoprocessing object 
import arcgisscripting 
gp = arcgisscripting.create() 
gp.RasterCatalogToRasterDataset_management(r"C:\RasterData\fgdb.gdb\test", r"C:\RasterData\fgdb.gdb\testrd", "\"OBJECTID\" <= 3", "LAST", "FIRST", "OBJECTID", "ASCENDING", "16_BIT_UNSIGNED", "COLOR_BALANCING", "STATISTIC_MATCHING", "SPECIFY_OID", "1")

Raster Catalog To Raster Dataset (Data Management)

Usage tips

Syntax

See Also