Help

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 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 cannot be specified.

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 for Desktop Basic: Yes
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics