Create Pansharpened Raster Dataset (Data Management)

Summary

Combines a high-resolution panchromatic raster dataset with a lower-resolution multiband raster dataset to create a high-resolution multiband raster dataset for visual analysis.

To learn more about pan sharpening, see Fundamentals of pan 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, MRF, CRF or any geodatabase raster dataset.

  • The four weight values assigned to the blue, green, red, and infrared bands allow you to adjust the pan-sharpening algorithms.

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

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

Parameters

LabelExplanationData Type
Input 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
Output 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:

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:

  • .bil for Esri BIL
  • .bip for Esri BIP
  • .bmp for BMP
  • .bsq for Esri BSQ
  • .dat for ENVI DAT
  • .gif for GIF
  • .img for ERDAS IMAGINE
  • .jpg for JPEG
  • .jp2 for JPEG 2000
  • .png for PNG
  • .tif for TIFF
  • .mrf for MRF
  • .crf for CRF
  • 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 geoprocessing Environments.

Raster Dataset
Panchromatic Image

The higher-resolution panchromatic image.

Raster Layer
Pan-sharpening 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
(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
  • DubaiSat-2 —The DubaiSat-2 satellite sensor
  • GeoEye-1 —The GeoEye-1 and OrbView-3 satellite sensors
  • GF-1 PMS —The Gao Fen satellite 1, Panchromatic and Multispectral CCD Camera
  • GF-2 PMS —The Gao Fen 2 satellite, Panchromatic and Multispectral CCD Camera
  • IKONOS —The IKONOS satellite sensor
  • Jilin-1 —The Jilin-1 satellite sensor
  • KOMPSAT-2 —The KOMPSAT-2 satellite sensor
  • KOMPSAT-3 —The KOMPSAT-3 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
  • SkySat-C —The SkySat-C satellite sensor
  • SPOT 5 —The SPOT 5 satellite sensor
  • SPOT 6 —The SPOT 6 satellite sensor
  • SPOT 7 —The SPOT 7 satellite sensor
  • Tian Hui 1 —The Tian Hui 1 satellite sensor
  • Ultracam —The UltraCam aerial sensor
  • WorldView-2 —The WorldView-2 satellite sensor
  • WorldView-3 —The WorldView-3 satellite sensor
  • WorldView-4 —The WorldView-4 satellite sensor
  • ZY-1 PMS —The Ziyuan High Panchromatic Multispectral Sensor
  • ZY-3 CRESDA —The Ziyuan CRESDA satellite sensor
  • ZY-3 SASMAC —The Ziyuan SASMAC satellite sensor
String

arcpy.management.CreatePansharpenedRasterDataset(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})
NameExplanationData 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:

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:

  • .bil for Esri BIL
  • .bip for Esri BIP
  • .bmp for BMP
  • .bsq for Esri BSQ
  • .dat for ENVI DAT
  • .gif for GIF
  • .img for ERDAS IMAGINE
  • .jpg for JPEG
  • .jp2 for JPEG 2000
  • .png for PNG
  • .tif for TIFF
  • .mrf for MRF
  • .crf for CRF
  • 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 geoprocessing Environments.

Raster Dataset
in_panchromatic_image

The higher-resolution panchromatic image.

Raster Layer
pansharpening_type

The algorithm to fuse the panchromatic and multispectral bands together.

  • 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.
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
(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
  • DubaiSat-2The DubaiSat-2 satellite sensor
  • GeoEye-1The GeoEye-1 and OrbView-3 satellite sensors
  • GF-1 PMSThe Gao Fen satellite 1, Panchromatic and Multispectral CCD Camera
  • GF-2 PMSThe Gao Fen 2 satellite, Panchromatic and Multispectral CCD Camera
  • IKONOSThe IKONOS satellite sensor
  • Jilin-1The Jilin-1 satellite sensor
  • KOMPSAT-2The KOMPSAT-2 satellite sensor
  • KOMPSAT-3The KOMPSAT-3 satellite sensor
  • Landsat 1-5 MSSThe Landsat MSS satellite sensors
  • Landsat 7 ETM+The Landsat 7 satellite sensor
  • Landsat 8The Landsat 8 satellite sensor
  • Pleiades-1The Pleiades-1 satellite sensor
  • QuickBirdThe QuickBird satellite sensor
  • SkySatThe SkySat-C satellite sensor
  • SPOT 5The SPOT 5 satellite sensor
  • SPOT 6The SPOT 6 satellite sensor
  • SPOT 7The SPOT 7 satellite sensor
  • TH-01The Tian Hui 1 satellite sensor
  • UltraCamThe UltraCam aerial sensor
  • WorldView-2The WorldView-2 satellite sensor
  • WorldView-3The WorldView-3 satellite sensor
  • WorldView-4The WorldView-4 satellite sensor
  • ZY1-02C PMSThe Ziyuan High Panchromatic Multispectral Sensor
  • ZY3-CRESDAThe Ziyuan CRESDA satellite sensor
  • ZY3-SASMACThe Ziyuan SASMAC 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")

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics