Make a Red-Green-Blue plot based on three layers in a SpatRaster. The layers (sometimes referred to as "bands" because they may represent different bandwidths in the electromagnetic spectrum) are combined such that they represent the red, green and blue channel. This function can be used to make "true" (or "false") color images from Landsat and other multi-spectral satellite images.
Note that the margins of the plot are set to zero (no axes or titles are visible) but can be set with the <code>mar</code> argument.
An alternative way to plot RGB images is to first use <code>colorize</code> to create a single layer SpatRaster with a color-table and then use <code><a href="/link/plot?package=terra&version=1.8-86" data-mini-rdoc="terra::plot">plot</a></code>.

plotRGB

Methods for spatial data analysis with vector (points, lines, polygons) and raster (grid) data. Methods for vector data include geometric operations such as intersect and buffer. Raster methods include local, focal, global, zonal and geometric operations. The predict and interpolate methods facilitate the use of regression type (interpolation, machine learning) models for spatial prediction, including with satellite remote sensing data. Processing of very large files is supported. See the manual and tutorials on <https://rspatial.org/> to get started.

Robert Hijmans

terra

Spatial Data Analysis

Robert J. Hijmans

Márcia Barbosa

Roger Bivand

Andrew Brown

Michael Chirico

Emanuele Cordano

Krzysztof Dyba

Edzer Pebesma

Barry Rowlingson

Michael D. Sumner

plotRGB function

Make a Red-Green-Blue plot based on three layers in a SpatRaster. The layers (sometimes referred to as "bands" because they may represent different bandwidths in the electromagnetic spectrum) are combined such that they represent the red, green and blue channel. This function can be used to make "true" (or "false") color images from Landsat and other multi-spectral satellite images.
Note that the margins of the plot are set to zero (no axes or titles are visible) but can be set with the <code>mar</code> argument.
An alternative way to plot RGB images is to first use <code>colorize</code> to create a single layer SpatRaster with a color-table and then use <code><a href='https://rdrr.io/pkg/terra/man/plot.html'>plot</a></code>.

Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB

<dl>

 <dt>x</dt>
<dd>SpatRaster</dd>

 <dt>r</dt>
<dd>integer between 1 and <code>nlyr(x)</code>. Layer to use as the Red channel</dd>

 <dt>g</dt>
<dd>integer between 1 and <code>nlyr(x)</code>. Layer to use as the Green channel</dd>

 <dt>b</dt>
<dd>integer between 1 and <code>nlyr(x)</code>. Layer to use as the Blue channel</dd>

 <dt>a</dt>
<dd>NULL or integer between 1 and <code>nlyr(x)</code>. Layer to use as the alpha (transparency) channel. If not NULL, argument <code>alpha</code> is ignored</dd>

 <dt>scale</dt>
<dd>integer. Maximum (possible) value in the three channels. Defaults to 255 or to the maximum value of <code>x</code> if that is known and larger than 255</dd>

 <dt>mar</dt>
<dd>numeric vector recycled to length 4 to set the margins of the plot. Use <code>mar=NULL</code> or <code>mar=NA</code> to not set the margins</dd>

 <dt>stretch</dt>
<dd>character. Option to stretch the values to increase contrast: "lin" (linear) or "hist" (histogram). The linear stretch uses <code>stretch</code> with arguments <code>minq=0.02</code> and <code>maxq=0.98</code></dd>

 <dt>smooth</dt>
<dd>logical. If <code>TRUE</code>, smooth the image when drawing to get the appearance of a higher spatial resolution</dd>

 <dt>colNA</dt>
<dd>color. The color used for cells that have NA values</dd>

 <dt>alpha</dt>
<dd>transparency. Integer between 0 (transparent) and 255 (opaque)</dd>

 <dt>bgalpha</dt>
<dd>Background transparency. Integer between 0 (transparent) and 255 (opaque)</dd>

 <dt>zlim</dt>
<dd>numeric vector of length 2. Range of values to plot (optional). If this is set, and <code>stretch="lin"</code> is used, then the values are stretched within the range of <code>zlim</code>. This allows creating consistent coloring between SpatRasters with different cell-value ranges, even when stretching the colors for improved contrast</dd>

 <dt>zcol</dt>
<dd>logical. If <code>TRUE</code> the values outside the range of zlim get the color of the extremes of the range. Otherwise, the values outside the zlim range get the color of <code>NA</code> values (see argument "colNA")</dd>

 <dt>axes</dt>
<dd>logical. If <code>TRUE</code> axes are drawn (and arguments such as <code>main="title"</code> will be honored)</dd>

 <dt>...</dt>
<dd>graphical parameters as in <code><a href='https://rdrr.io/r/graphics/plot.default.html'>plot</a></code>&lt;SpatRaster-method&gt;</dd>

</dl>

Arguments

Red-Green-Blue plot of a multi-layered SpatRaster

plotRGB: Red-Green-Blue plot of a multi-layered SpatRaster

Description

Usage

Arguments

See Also

Examples