GDAL-RASTER-COLOR-MAP(1)             GDAL             GDAL-RASTER-COLOR-MAP(1)

<?><?><?> (NAME)
       gdal-raster-color-map - <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> RGB <?><?> RGBA <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>

       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.11.


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)

          Usage: gdal raster color-map [OPTIONS] <INPUT> <OUTPUT>

          Generate a RGB or RGBA dataset from a single band, using a color map

          Positional arguments:
            -i, --input <INPUT>                                  Input raster datasets [required] [not available in pipelines]
            -o, --output <OUTPUT>                                Output raster dataset [required] [not available in pipelines]

          Common Options:
            -h, --help                                           Display help message and exit
            --json-usage                                         Display usage as JSON document and exit
            --config <KEY>=<VALUE>                               Configuration option [may be repeated]
            -q, --quiet                                          Quiet mode (no progress bar or warning message) [not available in pipelines]

          Options:
            -f, --of, --format, --output-format <OUTPUT-FORMAT>  Output format ("GDALG" allowed) [not available in pipelines]
            --co, --creation-option <KEY>=<VALUE>                Creation option [may be repeated] [not available in pipelines]
            --overwrite                                          Whether overwriting existing output dataset is allowed [not available in pipelines]
                                                                 Mutually exclusive with --append
            --append                                             Append as a subdataset to existing output [not available in pipelines]
                                                                 Mutually exclusive with --overwrite
            -b, --band <BAND>                                    Input band (1-based index) (default: 1)
            --color-map <COLOR-MAP>                              Color map filename
            --add-alpha                                          Adds an alpha mask band to the destination.
            --color-selection <COLOR-SELECTION>                  How to compute output colors from input values. COLOR-SELECTION=interpolate|exact|nearest (default: interpolate)

          Advanced Options:
            --if, --input-format <INPUT-FORMAT>                  Input formats [may be repeated] [not available in pipelines]
            --oo, --open-option <KEY>=<VALUE>                    Open options [may be repeated] [not available in pipelines]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gdal raster color-map <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?> (color map)--<?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>--<?><?>
       <?><?><?><?><?><?> <?><?><?><?> RGB <?><?> RGBA <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (hypsometric) <?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (DEM) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> gdal raster pipeline <?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?> GDALG (<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> /
       <?><?><?><?><?><?>)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> JSON
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> GDALG
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> GDALG: GDAL Streamed Algorithm <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?><?> (pipeline)
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (on-the-fly) <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (PROGRAM-SPECIFIC OPTIONS)

       --add-alpha
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> (alpha mask)
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -b, --band <BAND>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> (<?><?><?><?> <?><?> <?>).

       --color-map <COLOR-MAP>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?>.

              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?> <?><?> <?><?><?>: <?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              (Red)<?> <?><?><?> (Green) <?> <?><?><?> (Blue) (<?><?><?> <?>
              <?><?> <?><?><?>). <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> nv
              <?><?><?><?> <?><?><?><?><?> nodata <?><?><?><?>.  <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?>: 0% <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?> 100%
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?>.

              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> (<?><?><?>) <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?>
              ':'.

              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> GRASS <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> RGB <?><?><?><?>
              <?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?>: white<?> black<?> red<?>
              green<?> blue<?> yellow<?> magenta<?> cyan<?> aqua<?>
              grey/gray<?> orange<?> brown<?> purple/violet <?> indigo.
                 <?><?><?><?><?><?><?><?> <?><?><?><?> GMT <?><?>
                 <?><?><?><?><?> .cpt <?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?> (<?><?><?><?> <?><?> COLOR_MODEL =
                 RGB).

              <?><?><?><?>: <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              r.colors <?><?> GRASS <?><?><?><?><?> <?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> ESRI HDR <?><?>
              <?><?><?><?><?> (.clr) <?><?><?> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> GDAL <?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?>:

                 3500   white
                 2500   235:220:175
                 50%   190 185 135
                 700    240 250 150
                 0      50  180  50
                 nv     0   0   0   0

              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <<<?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>>> ("round to the
              floor value")<?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?> [0,10]<?> <?><?><?> <?><?> ]10,20] <?>
              <?><?><?> <?><?> ]20,30]:

                 0       red
                 10      red
                 10.001  green
                 20      green
                 20.001  blue
                 30      blue

       --color-selection interpolate|exact|nearest
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?>:

              o interpolate (<?><?><?><?><?><?><?>): <?><?><?><?><?><?> <?><?>
                <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
                <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
                <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
                <?><?><?><?><?> <?><?><?><?><?><?>.

              o exact: <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
                <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
                <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                <?><?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?>
                <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                <?><?><?><?><?><?><?><?><?><?> RGBA <?><?> <?><?><?><?>
                "0,0,0,0" <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

              o nearest: <?><?> <?><?><?><?><?><?> <?><?><?><?>
                <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
                <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
                <?><?><?><?><?><?><?>.

              <?><?><?><?>:
                 <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?> <?><?> --color-map
                 <?><?><?><?> <?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD OPTIONS)

       --co, --creation-option <NAME>=<VALUE>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> GeoTIFF <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --formats
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> Raster drivers
              <?><?><?><?><?><?> <?><?><?><?>.

       -f, --of, --format, --output-format <OUTPUT-FORMAT>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?> <?><?><?><?>: gdal --formats | grep
              raster | grep rw | sort

       --overwrite
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              gdal <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> 0 <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?>: <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       RGB <?><?> <?><?> <?><?><?><?> DTED0 <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>

          $ gdal raster color-map --color-map=color-map.txt n43.dt0 out.tif --overwrite

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Even Rouault <even.rouault@spatialys.com>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       1998-2026

                                August 18, 2026       GDAL-RASTER-COLOR-MAP(1)