Create Pan-sharpened Raster Dataset (Data Management)

License Level:BasicStandardAdvanced

Summary

Fuses a high-resolution panchromatic raster dataset with a lower-resolution multiband raster dataset to create a red-green-blue (RGB) raster with the resolution of the panchromatic raster.

Learn about panchromatic sharpening

Usage

Syntax

CreatePansharpenedRasterDataset_management (in_raster, red_channel, green_channel, blue_channel, {infrared_channel}, out_raster_dataset, in_panchromatic_image, pansharpening_type, {red_weight}, {green_weight}, {blue_weight}, {infrared_weight}, {sensor})
ParameterExplanationData Type
in_raster

The input raster dataset that you want to pan-sharpen.

Typically, this is a low-resolution multiband raster dataset.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
red_channel

The input raster band that you want to display with the red color channel.

Long
green_channel

The input raster band that you want to display with the green color channel.

Long
blue_channel

The input raster band that you want to display with the blue color channel.

Long
infrared_channel
(Optional)

The input infrared raster band. An infrared band does not exist for every raster dataset.

Long
out_raster_dataset

The output raster dataset.

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
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • no extension for 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.

Raster Dataset
in_panchromatic_image

The panchromatic raster dataset. Typically, this is a high-resolution grayscale image.

Raster Layer
pansharpening_type

The pan-sharpening method:

  • IHSUses Intensity, Hue, and Saturation color space for data fusion.
  • BROVEYUses the Brovey algorithm based on spectral modeling for data fusion.
  • EsriUses the ESRI algorithm based on spectral modeling for data fusion.
  • SIMPLE_MEANUses the averaged value between the red, green, and blue values and the panchromatic pixel value.
  • Gram-SchmidtUses the Gram-Schmidt spectral-sharpening algorithm to sharpen multispectral data.
LegacyLegacy:

Older scripts and models may still use the old keyword. With the ArcGIS 10.1 release, this keyword was replaced with Simple_Mean. Both keywords will continue to work, but for clarity it may be worthwhile to update it to the new keyword.

String
red_weight
(Optional)

The weight value for the red band.

Double
green_weight
(Optional)

The weight value for the green band.

Double
blue_weight
(Optional)

The weight value for the blue band.

Double
infrared_weight
(Optional)

The weight value for the infrared band. This parameter is only valid if an infrared band exists and the infrared option is used.

Double
sensor
[sensor,...]
(Optional)

When the Gram-Schmidt pan-sharpening method is chosen, you can also specify the sensor of the multiband raster input. Choosing the sensor type will set appropriate band weights.

  • UNKNOWNAn unknown or unlisted sensor.
  • GeoEye-1The GeoEye-1 and OrbView-3 satellite sensors.
  • IKONOSThe IKONOS satellite sensor.
  • KOMPSAT-2The KOMPSAT-2 satellite sensor.
  • Landsat 1-5 MSSThe Landsat MSS satellite sensors.
  • Landsat 7 ETM+The Landsat 7 satellite sensor.
  • QuickBirdThe QuickBird satellite sensor.
  • SPOT 5The SPOT 5 satellite sensor.
  • UltraCamThe UltraCam aerial sensor.
  • WorldView-2The WorldView-2 satellite sensor.
String

Code Sample

CreatePansharpenedRasterDataset example 1 (Python window)

This is a Python sample for the CreatePansharpenedRasterDataset tool.

import arcpy
arcpy.CreatePansharpenedRasterDataset_management(
     "c:/data/rgbn.tif","3","2","1","4", "c:/data/outpan.tif",
     "c:/data/in_pan.img","Gram-Schmidt","","","","","QuickBird")
CreatePansharpenedRasterDataset example 2 (stand-alone script)

This is a Python script sample for the CreatePansharpenedRasterDataset tool.

#3 Band RGB Pansharpen with Brovey algorithm

import arcpy
arcpy.env.workspace = "C:/workspace"
    
arcpy.CreatePansharpenedRasterDataset_management(
     "rgb.img","3","2","1","1", "output\\rgb_pan.img","pan.img","Brovey")

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
11/18/2013