Create Color Composite (Image Analyst)

Summary

Creates a three-band raster dataset from a multiband raster dataset.

Usage

• When defining the band arithmetic algorithm, you can enter a single-line algebraic formula for each expression to create a multiband output. The supported operators are unary, plus (+), minus (-), times (*), and divide (/).

• When using a band ID in an expression, identify the band by prefixing the letter B or b to the band number.

• A common band combination used for dual-polarized synthetic aperture radar (SAR) in linear units is VV for red, VH for green, and VV/VH for blue. If the input data is in decibels, the band combination should be VV for red, VH for green, and VV-VH for blue.

Parameters

Dialog

Label	Explanation	Data Type
Input Raster	The input multiband raster data.	Raster Dataset; Raster Layer
Output Raster	The output three-band composite raster.	Raster Dataset
Method	Specifies the method that will be used to extract bands. Band names—The band name representing the wavelength interval on the electromagnetic spectrum (such as Red, Near Infrared, or Thermal Infrared) or the polarization (such as VH, VV, HH, or HV) will be used. This is the default. Band IDs— The band number (such as B1, B2, or B3) will be used.	String
Red Expression	The calculation that will be assigned to the first band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String
Green Expression	The calculation that will be assigned to the second band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String
Blue Expression	The calculation that will be assigned to the third band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String

Python

CreateColorComposite(in_raster, out_raster, method, red_expression, green_expression, blue_expression)

Name	Explanation	Data Type
in_raster	The input multiband raster data.	Raster Dataset; Raster Layer
out_raster	The output three-band composite raster.	Raster Dataset
method	Specifies the method that will be used to extract bands. BAND_NAMES—The band name representing the wavelength interval on the electromagnetic spectrum (such as Red, Near Infrared, or Thermal Infrared) or the polarization (such as VH, VV, HH, or HV) will be used. This is the default. BAND_IDS— The band number (such as B1, B2, or B3) will be used.	String
red_expression	The calculation that will be assigned to the first band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String
green_expression	The calculation that will be assigned to the second band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String
blue_expression	The calculation that will be assigned to the third band. A band name, band ID, or an algebraic expression using the bands. The supported operators are unary: plus (+), minus (-), times (*), and divide (/).	String

Code sample

CreateColorComposite example 1 (Python window)

This example creates a color composite using the band names VV, VH, and VV/VH.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"
out_raster = arcpy.ia.CreateColorComposite(
   "IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC.crf", "BAND_NAMES", "VV", "VH", "VV/VH")
out_raster.save = ("IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_RGB.crf")

CreateColorComposite example 2 (stand-alone script)

This example creates a color composite using the band names VV, VH, and VV-VH.

# Import system modules 
import arcpy 

# Define input parameters 
in_raster = r"C:\Data\SAR\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB.crf"
out_raster = r"C:\Data\SAR\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB_RGB.crf"
method = "BAND_NAMES"
redExp = "VV"
greenExp = "VH"
blueExp = "VV-VH" 

out = arcpy.ia.CreateColorComposite(in_raster, method, redExp, greenExp, blueExp)
out.save(out_raster)

CreateColorComposite example 3 (Python window)

This example creates a color composite using the band IDs B1, B2, and B1/B2.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"
out_raster = arcpy.ia.CreateColorComposite(
    "IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC.crf", "BAND_IDS", "B1", "B2", "B1/B2")
out_raster.save = ("IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_RGB.crf")

Environments

Cell Alignment, Cell Size, Compression, Current Workspace, Extent, Geographic Transformations, NoData, Output Coordinate System, Parallel Processing Factor, Pyramid, Raster Statistics, Resampling Method, Scratch Workspace, Snap Raster, Tile Size