Skip To Content

Add Colormap

Summary

Adds a new colormap or replaces an existing colormap on a raster dataset.

Usage

  • The color map applied to the input raster dataset can originate from a raster dataset that already has a color map, a .clr file, or an .act file.

  • This tool will not work when the color map is internally stored in the attribute table of an IMG or a TIFF dataset. If the attribute table contains the fields Red, Green, and Blue, that means this tool cannot be used.

  • The input raster dataset must be a single band raster dataset with integer values. Color maps can only be created for single-band raster datasets with a pixel depth of 16-bit unsigned or fewer. Certain formats cannot have a color map associated with them; please consult the Supported raster dataset file formats.

Syntax

AddColormap_management (in_raster, {in_template_raster}, {input_CLR_file})
ParameterExplanationData Type
in_raster

The raster dataset to add or replace a color map.

Raster Layer
in_template_raster
(Optional)

A raster dataset that has a colormap that you want to apply to the input raster dataset. If this is entered the input_CLR_file parameter is ignored.

Raster Layer
input_CLR_file
(Optional)

Specify a .clr or .act file to use as the colormap.

File

Code sample

AddColormap example (Python window)

This is a Python sample for AddColormap.

import arcpy
arcpy.AddColormap_management("c:/data/nocolormap.img", "#",
                             "colormap_file.clr")
AddColormap example 2 (stand-alone script)

This is a Python script sample for AddColormap.

##====================================
##Add Colormap
##Usage: AddColormap_management in_raster {in_template_raster} {input_CLR_file}

import arcpy
arcpy.env.workspace = r"C:/Workspace"

##Assign colormap using template image
arcpy.AddColormap_management("nocolormap.img", "colormap.tif", "#")

##Assign colormap using clr file
arcpy.AddColormap_management("nocolormap.img", "#", "colormap_file.clr")

Environments

Licensing information

  • ArcGIS Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes