Geoprocessing tool reference > Data Management toolbox > Raster toolset > Tools
Create Pan-Sharpened Raster Dataset (Data Management) |
|
|
Release 9.2
Last modified November 29, 2010 |
Print all topics in : "Tools" |
Fuses a high-resolution panchromatic raster dataset with a lower-resolution multiband raster dataset to create an RGB raster with the resolution of the panchromatic raster.
Learn more about panchromatic sharpening
Usage tips
-
You can save your output to BMP, GIF, GRID, IMG, JPEG, JPEG2000, PNG, TIFF, or any geodatabase raster dataset.
-
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: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID.
-
When storing your raster dataset to a geodatabase, you can specify a compression type and compression quality within the Raster Storage Settings in the Environment Settings dialog box.
-
IHS uses Intensity, Hue, and Saturation color space for data fusion. Brovey and ESRI use an algorithm based on spectral modeling for data fusion.
-
The Simple Mean method uses the averaged pixel value between the original red, green, and blue values and the panchromatic pixel value. This is done for each of the colors (red, green, and blue).
- NewRedValue = ((OldRedValue + PanValue) / 2)
- NewGreenValue = ((OldGreenValue + PanValue) / 2)
- NewBlueValue = ((OldBlueValue + PanValue) / 2)
-
The four weight values allow you to adjust the pan-sharpening algorithms. All weights summed up should equal a total of one.
-
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-band raster dataset (three bands that have been pan-sharpened and the infrared band).
-
Only the areas that fully overlap will be affected by this tool.
-
The following environments affect this tool: current workspace, scratch workspace, output coordinate system, output extent, output CONFIG keyword, pyramid, raster statistics, compression, and tile size.
Command line syntax
An overview of the Command Line window
CreatePansharpenedRasterDataset_management <in_raster> {red_channel} {green_channel} {blue_channel} {infrared_channel} <out_raster_dataset> <in_panchromatic_image> <IHS | Brovey | ESRI | Simple Mean> {red_weight} {green_weight} {blue_weight} {infrared_weight}
| Parameter | Explanation | Data Type |
| <in_raster> |
The input raster dataset that you want to pan-sharpen. Typically this is a low-resolution multi-band raster dataset. |
Raster Layer |
| {red_channel} |
The input raster band that you want to display with the red color gun. |
Long |
| {green_channel} |
The input raster band that you want to display with the green color gun. |
Long |
| {blue_channel} |
The input raster band that you want to display with the blue color gun. |
Long |
| {infrared_channel} |
The input infrared raster band. An infrared band does not exist for every raster dataset. |
Long |
| <out_raster_dataset> |
The output raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID. When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality. |
Raster Dataset |
| <in_panchromatic_image> |
The panchromatic raster dataset. Typically this is a high-resolution grayscale image. |
Raster Dataset |
| <IHS | Brovey | ESRI | Simple Mean> |
The pan-sharpening method:
|
String |
| {red_weight} |
The weight value for the red band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| {green_weight} |
The weight value for the green band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| {blue_weight} |
The weight value for the blue band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| {infrared_weight} |
The weight value for the infrared band. This parameter is only valid if an infrared band exists and the infrared option is used. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
Command line example
CreatePansharpenedRasterDataset c:/Redlands_data/Redlands.tif 1 2 3 1 c:/Redlands_data/Redlands_pansharp.img c:/Redlands_data/Redlands_pan.tif ESRI 0.1666 0.167 0.167 0.5
Scripting syntax
About getting started with writing geoprocessing scripts
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)
| Parameter | Explanation | Data Type |
| in_raster (Required) |
The input raster dataset that you want to pan-sharpen. Typically this is a low-resolution multi-band raster dataset. |
Raster Layer |
| red_channel (Optional) |
The input raster band that you want to display with the red color gun. |
Long |
| green_channel (Optional) |
The input raster band that you want to display with the green color gun. |
Long |
| blue_channel (Optional) |
The input raster band that you want to display with the blue color gun. |
Long |
| infrared_channel (Optional) |
The input infrared raster band. An infrared band does not exist for every raster dataset. |
Long |
| out_raster_dataset (Required) |
The output raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID. When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality. |
Raster Dataset |
| in_panchromatic_image (Required) |
The panchromatic raster dataset. Typically this is a high-resolution grayscale image. |
Raster Dataset |
| pansharpening_type (Required) |
The pan-sharpening method:
|
String |
| red_weight (Optional) |
The weight value for the red band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| green_weight (Optional) |
The weight value for the green band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| blue_weight (Optional) |
The weight value for the blue band. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
| infrared_weight (Optional) |
The weight value for the infrared band. This parameter is only valid if an infrared band exists and the infrared option is used. All the weight values (red, green, blue, and infrared) should equal a sum of one. |
Double |
Data types for geoprocessing tool parameters
Script example
# Create the geoprocessing object
import arcgisscripting
gp = arcgisscripting.create()
gp.workspace = "c:/Redlands_data"
gp.CreatePansharpenedRasterDataset_management("Redlands.tif","1","2","3","1","Redlands_pansharp.img", "Redlands_pan.tif", 'ESRI','0.166','0.167','0.167','0.5')