Create Pan-sharpened Raster Dataset (Data Management)
Summary
Fuses a high-resolution panchromatic raster dataset with a lower-resolution multiband raster dataset to create a red-green-blue (RGB) raster with the resolution of the panchromatic raster.
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, or any geodatabase raster dataset.
-
The four weight values allow you to adjust the pan-sharpening algorithms.
-
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 bands.
Syntax
Parameter | Explanation | Data Type |
in_raster |
The input raster dataset that you want to pan-sharpen. Typically, this is a low-resolution multiband raster dataset. | 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 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:
When storing a raster dataset in a geodatabase, no file extension should be added 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. | Raster Dataset |
in_panchromatic_image |
The panchromatic raster dataset. Typically, this is a high-resolution grayscale image. | Raster Layer |
pansharpening_type |
The pan-sharpening method:
Legacy: Older scripts and models may still use the old keyword. With the ArcGIS 10.1 release, this keyword was replaced with Simple_Mean. Both keywords will continue to work, but for clarity it may be worthwhile to update it to the new keyword. | String |
red_weight (Optional) |
The weight value for the red band. | Double |
green_weight (Optional) |
The weight value for the green band. | Double |
blue_weight (Optional) |
The weight value for the blue band. | 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. | Double |
sensor [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.
| String |
Code Sample
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")
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")