.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-RASTER-SELECT" "1" "May 06, 2025" "" "GDAL"
.SH NAME
gdal-raster-select \- Select a subset of bands from a raster dataset
.sp
Added in version 3.11.

.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster select [OPTIONS] <INPUT> <OUTPUT> <BAND>

Select a subset of bands from a raster dataset.

Positional arguments:
  \-i, \-\-input <INPUT>                                  Input raster dataset [required]
  \-o, \-\-output <OUTPUT>                                Output raster dataset [required]
  \-b, \-\-band <BAND>                                    Band(s) (1\-based index, \(aqmask\(aq or \(aqmask:<band>\(aq) [1.. values] [required]

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]
  \-\-progress                                           Display progress bar

Options:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format (\(dqGDALG\(dq allowed)
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated]
  \-\-overwrite                                          Whether overwriting existing output is allowed
  \-\-mask <MASK>                                        Mask band (1\-based index, \(aqmask\(aq, \(aqmask:<band>\(aq or \(aqnone\(aq)

Advanced Options:
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  Input formats [may be repeated]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    Open options [may be repeated]
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgdal raster select\fP can be used to select and re\-order a subset of
raster bands from a raster dataset.
.sp
This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
.SS Standard options
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
Which output raster format to use. Allowed values may be given by
\fBgdal \-\-formats | grep raster | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co <NAME>=<VALUE>
Many formats have one or more optional creation options that can be
used to control particulars about the file created. For instance,
the GeoTIFF driver supports creation options to control compression,
and whether the file should be tiled.
.sp
May be repeated.
.sp
The creation options available vary by format driver, and some
simple formats have no creation options at all. A list of options
supported for a format can be listed with the
\fI\%\-\-formats\fP
command line option but the documentation for the format is the
definitive source of information on driver creation options.
See \fI\%Raster drivers\fP format
specific documentation for legal creation options for each format.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
Allow program to overwrite existing target file or dataset.
Otherwise, by default, \fBgdal\fP errors out if the target file or
dataset already exists.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-band <BAND>
Select one or several input bands. Bands are numbered from 1.
Multiple values may be selected to select a set of input bands
to write to the output file, or to reorder bands. The special value \fBmask\fP
means the mask band of the first band of the input dataset. The mask band
of any band can be specified with \fBmask:<band>\fP\&. A mask band selected
with \fB\-\-band\fP will become an ordinary band in the output dataset.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mask <BAND>
Select one input band to create output dataset mask band.. Bands are numbered from 1.
The special value \fBmask\fP means the mask band of the first band of the input dataset. The mask band
of any band can be specified with \fBmask:<band>\fP\&.
<BAND> can be set to \fBnone\fP to avoid copying the global
mask of the input dataset if it exists. Otherwise it is copied by default,
unless the mask is an alpha channel, or if it is explicitly selected
to be a regular band of the output dataset (\fB\-\-band mask\fP)
.UNINDENT
.SH GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)
.sp
This program supports serializing the command line as a JSON file using the \fBGDALG\fP output format.
The resulting file can then be opened as a raster dataset using the
\fI\%GDALG: GDAL Streamed Algorithm\fP driver, and apply the specified pipeline in a on\-the\-fly /
streamed way.
.SH EXAMPLES
.SS Example 1: Reorder a 3\-band dataset with bands ordered Blue, Green, Red to Red, Green, Blue
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster select \-\-band 3,2,1 bgr.tif rgb.tif \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SS Example 2: Convert a RGBA dataset to a YCbCR JPEG compressed GeoTIFF
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster select \-\-band 1,2,3 \-\-mask 4 \-\-co COMPRESS=JPEG,PHOTOMETRIC=YCBCR rgba.tif rgb_mask.tif
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2025
.\" Generated by docutils manpage writer.
.