Help

Create Pansharpened Raster Dataset

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

  • Only the areas that fully overlap will be affected by this tool.

  • You can save your output to BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.

  • The four weight values allow you to adjust the pan-sharpening algorithms.

  • Pan-sharpening that is performed on a three-band raster dataset will produce a raster dataset that has three bands.

    Pan-sharpening that is performed on a four-band raster dataset will produce a raster dataset that has four bands.

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 raster dataset that you want to pan-sharpen.

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 raster band that you want to display with the infrared color channel.

Long
out_raster_dataset

The name, location and format for the dataset you are creating.

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, do not add a file extension 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 in the Environment Settings.

Raster Dataset
in_panchromatic_image

The higher resolution panchromatic image.

Raster Layer
pansharpening_type

The algorithm to fuse the panchromatic and multispectral bands together.

  • IHS —Uses Intensity, Hue, and Saturation color space for data fusion.
  • BROVEY —Uses the Brovey algorithm based on spectral modeling for data fusion.
  • Esri —Uses the ESRI algorithm based on spectral modeling for data fusion.
  • SIMPLE_MEAN —Uses the averaged value between the red, green, and blue values and the panchromatic pixel value.
  • Gram-Schmidt —Uses the Gram-Schmidt spectral-sharpening algorithm to sharpen multispectral data.
String
red_weight
(Optional)

A value from 0 to 1 to weight the red band.

Double
green_weight
(Optional)

A value from 0 to 1 to weight the green band.

Double
blue_weight
(Optional)

A value from 0 to 1 to weight the blue band.

Double
infrared_weight
(Optional)

A value from 0 to 1 to weight the infrared band.

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.

  • UNKNOWN —An unknown or unlisted sensor.
  • GeoEye-1 —The GeoEye-1 and OrbView-3 satellite sensors.
  • IKONOS —The IKONOS satellite sensor.
  • KOMPSAT-2 —The KOMPSAT-2 satellite sensor.
  • Landsat 1-5 MSS —The Landsat MSS satellite sensors.
  • Landsat 7 ETM+ —The Landsat 7 satellite sensor.
  • Landsat 8 —The Landsat 8 satellite sensor.
  • Pleiades-1 —The Pleiades-1 satellite sensor.
  • QuickBird —The QuickBird satellite sensor.
  • SPOT 5 —The SPOT 5 satellite sensor.
  • SPOT 6 —The SPOT 6 satellite sensor.
  • UltraCam —The UltraCam aerial sensor.
  • WorldView-2 —The WorldView-2 satellite sensor.
  • WorldView-3 —The WorldView-3 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

Licensing information

  • ArcGIS for Desktop Basic: Yes
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics