.\" 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-READ" "1" "Jun 05, 2026" "" "GDAL"
.SH NAME
gdal-raster-read \- Read a raster dataset (pipeline only)
.sp
Added in version 3.11.

.SH DESCRIPTION
.sp
The \fBread\fP operation is for use in a \fI\%gdal pipeline\fP only, and reads a single input
raster dataset. This is the first step of a pipeline.
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
* read [OPTIONS] <INPUT>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

Read a raster dataset.

Positional arguments:
  \-i, \-\-input <INPUT>                  Input raster datasets [required]

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 STANDARD OPTIONS
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
Format/driver name to be attempted to open the input file(s). It is generally
not necessary to specify it, but it can be used to skip automatic driver
detection, when it fails to select the appropriate driver.
This option can be repeated several times to specify several candidate drivers.
Note that it does not force those drivers to open the dataset. In particular,
some drivers have requirements on file extensions.
.sp
May be repeated.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
Dataset open option (format specific).
.sp
May be repeated.
.UNINDENT
.SH EXAMPLES
.SS Example 1: Read a GeoTIFF file
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster pipeline read input.tif ! ... [other commands here] ...
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2026
.\" Generated by docutils manpage writer.
.