Create Color Composite (Data Management)

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.

Parameters

LabelExplanationData 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 namesThe 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

arcpy.management.CreateColorComposite(in_raster, out_raster, method, red_expression, green_expression, blue_expression)
NameExplanationData 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_NAMESThe 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 = "D:\Data\SAR\S1\20181014" 
arcpy.management.CreateColorComposite(
     "IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC.crf", 
     "IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_RGB.crf", "BAND_NAMES", "VV", 
     "VH", "VV/VH")
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 = "D:\Data\SAR\S1\20181014\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB.crf"
out_raster = "D:\Data\SAR\S1\20181014\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB_RGB.crf"
method = "BAND_NAMES"
redExp = "VV"
greenExp = "VH"
blueExp = "VV-VH" 

arcpy.management.CreateColorComposite(in_raster, out_raster, method, 
    redExp, greenExp, blueExp)

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics