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 the output to BIL, BIP, BMP, BSQ, DAT, Esri Grid , GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF, or CRF format or to 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 will be pan sharpened.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
Red Channel

The input raster band that will display with the red color channel.

Long
Green Channel

The input raster band that will display with the green color channel.

Long
Blue Channel

The input raster band that will display with the blue color channel.

Long
Infrared Channel
(Optional)

The input raster band that will display with the infrared color channel.

Long
Output Raster Dataset

The name, location, and format of the raster dataset that will be created.

When storing the raster dataset in a file format, specify the file extension as follows:

When storing a raster dataset in a geodatabase, do not add a file extension to the name of the raster dataset. When storing the raster dataset in a file format, you must 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 a raster dataset to a JPEG format file, a JPEG 2000 format file, a TIFF format file, or a geodatabase, you can specify Compression Type and Compression Quality values in the geoprocessing environments.

Raster Dataset
Panchromatic Image

The higher-resolution panchromatic image.

Raster Layer
Pan-sharpening Type

Specifies the algorithm that will be used to combine the panchromatic and multispectral bands.

  • IHSIntensity, Hue, and Saturation color space will be used.
  • BroveyThe Brovey algorithm based on spectral modeling will be used.
  • EsriThe Esri algorithm based on spectral modeling will be used.
  • Simple meanThe averaged value between the red, green, and blue values and the panchromatic pixel value will be used.
  • Gram-SchmidtThe Gram-Schmidt spectral-sharpening algorithm to sharpen multispectral data will be used.
String
Red Weight
(Optional)

A value from 0 to 1 that will be used to weight the red band.

Double
Green Weight
(Optional)

A value from 0 to 1 that will be used to weight the green band.

Double
Blue Weight
(Optional)

A value from 0 to 1 that will be used to weight the blue band.

Double
Infrared Weight
(Optional)

A value from 0 to 1 that will be used to weight the infrared band.

Double
Sensor
(Optional)

Specifies the sensor of the multiband raster input.

You can specify the sensor when the Pan-sharpening Type parameter is set to Gram-Schmidt. Specifying the sensor 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
  • Landsat 9The Landsat 9 satellite sensor
  • Pléiades-1The Pléiades satellite sensor
  • Pléiades NeoThe Pléiades Neo satellite sensor
  • QuickbirdThe QuickBird satellite sensor
  • SkySat-CThe SkySat-C satellite sensor
  • SPOT 5The SPOT 5 satellite sensor
  • SPOT 6The SPOT 6 satellite sensor
  • SPOT 7The SPOT 7 satellite sensor
  • SuperView-1The SuperView-1 satellite sensor
  • Tian Hui 1The 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
  • ZY-1 PMSThe Ziyuan High Panchromatic Multispectral Sensor
  • ZY-3 CRESDAThe Ziyuan CRESDA satellite sensor
  • ZY-3 SASMACThe 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 will be pan sharpened.

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

The input raster band that will display with the red color channel.

Long
green_channel

The input raster band that will display with the green color channel.

Long
blue_channel

The input raster band that will display with the blue color channel.

Long
infrared_channel
(Optional)

The input raster band that will display with the infrared color channel.

Long
out_raster_dataset

The name, location, and format of the raster dataset that will be created.

When storing the raster dataset in a file format, specify the file extension as follows:

When storing a raster dataset in a geodatabase, do not add a file extension to the name of the raster dataset. When storing the raster dataset in a file format, you must 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 a raster dataset to a JPEG format file, a JPEG 2000 format file, a TIFF format file, or a geodatabase, you can specify Compression Type and Compression Quality values in the geoprocessing environments.

Raster Dataset
in_panchromatic_image

The higher-resolution panchromatic image.

Raster Layer
pansharpening_type

Specifies the algorithm that will be used to combine the panchromatic and multispectral bands.

  • IHSIntensity, Hue, and Saturation color space will be used.
  • BROVEYThe Brovey algorithm based on spectral modeling will be used.
  • EsriThe Esri algorithm based on spectral modeling will be used.
  • SIMPLE_MEANThe averaged value between the red, green, and blue values and the panchromatic pixel value will be used.
  • Gram-SchmidtThe Gram-Schmidt spectral-sharpening algorithm to sharpen multispectral data will be used.
String
red_weight
(Optional)

A value from 0 to 1 that will be used to weight the red band.

Double
green_weight
(Optional)

A value from 0 to 1 that will be used to weight the green band.

Double
blue_weight
(Optional)

A value from 0 to 1 that will be used to weight the blue band.

Double
infrared_weight
(Optional)

A value from 0 to 1 that will be used to weight the infrared band.

Double
sensor
(Optional)

Specifies the sensor of the multiband raster input.

You can specify the sensor when the pansharpening_type parameter is set to Gram-Schmidt. Specifying the sensor 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
  • Landsat 9The Landsat 9 satellite sensor
  • Pleiades-1The Pléiades satellite sensor
  • Pleiades NeoThe Pléiades Neo 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
  • SuperView-1The SuperView-1 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 function.

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 function.

#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