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.

Syntax

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})
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:

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