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.

Learn more about 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.

  • UnknownThe sensor is unknown or unlisted.
  • BlackSkyThe sensor is a BlackSky satellite sensor.
  • DubaiSat-2The sensor is a DubaiSat-2 satellite sensor.
  • GeoEye-1The sensor is a GeoEye-1 and OrbView-3 satellite sensor.
  • GF-1 PMSThe sensor is a Gao Fen satellite 1, Panchromatic and Multispectral CCD Camera sensor.
  • GF-2 PMSThe sensor is a Gao Fen 2 satellite, Panchromatic and Multispectral CCD Camera sensor.
  • IKONOSThe sensor is an IKONOS satellite sensor.
  • Jilin-1The sensor is a Jilin-1 satellite sensor.
  • KOMPSAT-2The sensor is a KOMPSAT-2 satellite sensor.
  • KOMPSAT-3The sensor is a KOMPSAT-3 satellite sensor.
  • Landsat 1-5 MSSThe sensor is a Landsat MSS satellite sensor.
  • Landsat 7 ETM+The sensor is a Landsat 7 satellite sensor.
  • Landsat 8The sensor is a Landsat 8 satellite sensor.
  • Landsat 9The sensor is a Landsat 9 satellite sensor.
  • Pléiades-1The sensor is a Pléiades satellite sensor.
  • Pléiades NeoThe sensor is a Pléiades Neo satellite sensor.
  • QuickbirdThe sensor is a QuickBird satellite sensor.
  • SkySat-CThe sensor is a SkySat-C satellite sensor.
  • SPOT 5The sensor is a SPOT 5 satellite sensor.
  • SPOT 6The sensor is a SPOT 6 satellite sensor.
  • SPOT 7The sensor is a SPOT 7 satellite sensor.
  • SuperView-1The sensor is a SuperView-1 satellite sensor.
  • Tian Hui 1The sensor is a Tian Hui 1 satellite sensor.
  • UltracamThe sensor is an UltraCam aerial sensor.
  • Vision-1The sensor is a Vision-1 satellite sensor.
  • WorldView-2The sensor is a WorldView-2 satellite sensor.
  • WorldView-3The sensor is a WorldView-3 satellite sensor.
  • WorldView-4The sensor is a WorldView-4 satellite sensor.
  • ZY-1 PMSThe sensor is a Ziyuan High Panchromatic Multispectral Sensor.
  • ZY-3 CRESDAThe sensor is a Ziyuan CRESDA satellite sensor.
  • ZY-3 SASMACThe sensor is a 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.

  • UNKNOWNThe sensor is unknown or unlisted.
  • BlackSkyThe sensor is a BlackSky satellite sensor.
  • DubaiSat-2The sensor is a DubaiSat-2 satellite sensor.
  • GeoEye-1The sensor is a GeoEye-1 and OrbView-3 satellite sensor.
  • GF-1 PMSThe sensor is a Gao Fen satellite 1, Panchromatic and Multispectral CCD Camera sensor.
  • GF-2 PMSThe sensor is a Gao Fen 2 satellite, Panchromatic and Multispectral CCD Camera sensor.
  • IKONOSThe sensor is an IKONOS satellite sensor.
  • Jilin-1The sensor is a Jilin-1 satellite sensor.
  • KOMPSAT-2The sensor is a KOMPSAT-2 satellite sensor.
  • KOMPSAT-3The sensor is a KOMPSAT-3 satellite sensor.
  • Landsat 1-5 MSSThe sensor is a Landsat MSS satellite sensor.
  • Landsat 7 ETM+The sensor is a Landsat 7 satellite sensor.
  • Landsat 8The sensor is a Landsat 8 satellite sensor.
  • Landsat 9The sensor is a Landsat 9 satellite sensor.
  • Pleiades-1The sensor is a Pléiades satellite sensor.
  • Pleiades NeoThe sensor is a Pléiades Neo satellite sensor.
  • QuickBirdThe sensor is a QuickBird satellite sensor.
  • SkySatThe sensor is a SkySat-C satellite sensor.
  • SPOT 5The sensor is a SPOT 5 satellite sensor.
  • SPOT 6The sensor is a SPOT 6 satellite sensor.
  • SPOT 7The sensor is a SPOT 7 satellite sensor.
  • SuperView-1The sensor is a SuperView-1 satellite sensor.
  • TH-01The sensor is a Tian Hui 1 satellite sensor.
  • UltraCamThe sensor is an UltraCam aerial sensor.
  • Vision-1The sensor is a Vision-1 satellite sensor.
  • WorldView-2The sensor is a WorldView-2 satellite sensor.
  • WorldView-3The sensor is a WorldView-3 satellite sensor.
  • WorldView-4The sensor is a WorldView-4 satellite sensor.
  • ZY1-02C PMSThe sensor is a Ziyuan High Panchromatic Multispectral Sensor.
  • ZY3-CRESDAThe sensor is a Ziyuan CRESDA satellite sensor.
  • ZY3-SASMACThe sensor is a 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")

Related topics